QR SET DESTINATION

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 2003


QR SET DESTINATION (area; type; specifics)

ParameterTypeDescription
areaLongintReference of the area
typeLongintType of the report
specificsString | VariableSpecifics linked to the output type

Description

The QR SET DESTINATION command sets the output type of the report for the area whose reference was passed in area.

The following table describes the values that can be passed in both type and specifics parameters:

DestinationConstant (value)specifics
Printerqr printer (1)N.A.
Text fileqr text file (2)Pathname to the file
4D Viewqr 4D View area (3)N.A.
4D Chartqr 4D Chart area (4)N.A.
HTML fileqr HTML file (5)Pathname to the HTML file

Text file (2): If you pass an empty string as the file's pathname, a Save file dialog is displayed, otherwise the file is saved at the location indicated by the path.

The default field delimiter is the tab character (ASCII 9). The default record delimiter is the carriage return character (ASCII 13). You can change these defaults by assigning values to the two delimiter system variables: FldDelimit and RecDelimit. If under Windows, FldDelimit equals 13, a char 10 (line feed) will be appended after the carriage return. Be aware that these variables are used by other commands such as IMPORT TEXT for example. Changing them for the Quick Report editor, changes them everywhere in the application.

4D View (3): If 4D View is active for the user, a 4D View external window is created and populated with the results of the current settings of the Quick Report area.

4D Chart(4): A 4D Chart external window is created and populated with the results of the current settings of the Quick Report area. For detailed information on how the translation is performed, please refer to the User Reference section of the Quick Report Editor documentation.

HTML file(5): An HTML file is created using the template set by QR SET HTML TEMPLATE. For detailed information on how the translation is performed, please refer to the User Reference section of the Quick Report Editor documentation.

If you pass an invalid area number, the error -9850 will be generated.

If you pass an invalid destination value, the error -9852 will be generated.

Example

The following code sets the destination as being the text file Mydoc.txt and executes the Quick Report:

   QR SET DESTINATION(MyArea; 2; "MyDoc.txt")
   QR RUN(MyArea)

See Also

QR GET DESTINATION.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next