4D v13.4

QR SET DESTINATION

Home

 
4D v13.4
QR SET DESTINATION

QR SET DESTINATION 


 

QR SET DESTINATION ( area ; type {; specifics} ) 
Parameter Type   Description
area  Longint in Reference of the area
type  Longint in Type of the report
specifics  String, Variable in Specifics linked to the output type

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

In the type parameter, you can pass one of the constants of the QR Output Destination theme. The contents of the specifics parameter depends on the value of type. The following table describes the values that can be passed in both type and specifics parameters:

Constant Type Value Comment
qr 4D Chart area Longint 4 specifics: N.A.
qr 4D View area Longint 3 specifics: N.A.
qr HTML file Longint 5 specifics: Pathname to the file.
qr printer Longint 1 specifics: N.A.
qr text file Longint 2 specifics: Pathname to the file.

qr text file (2): If you pass an empty string in the specifics parameter, 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 (code 9). The default record delimiter is the carriage return character (code 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.

qr 4D View area (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.

qr 4D Chart area (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 Design Reference manual.

qr 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 Design Reference manual.

If you pass an invalid area number, the error -9850 will be generated.
If the value of the destination type is incorrect, 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;qr text file;"MyDoc.txt")
 QR RUN(MyArea)

 
PROPERTIES 

Product: 4D
Theme: Quick Report
Number: 745

This command modifies the Error system variable

 
INDEX

Alphabetical list of commands

 
HISTORY 

Created: 4D 2003

 
SEE ALSO 

QR GET DESTINATION