V. DATAform database interface
130
Developer handbook DATAformXTension © 1992-2004 www.gassenhuber.de
Return values of the function
DX_Message returns the following values:
0
No error occurred; the DATAformXTension response is received and it contains the error
value zero.
< 0 DX_Message generates the following negative error numbers:
Error -1 = timeout.
No message received. Possible causes:
The wait time was too short. QuarkXPress is not open. DATAformXTension is not
loaded. The message system is deactivated; the server activity is set to “none”. The
demo time of an XTension has run out (20 Minutes from QuarkXPress start). The fold-
er structure in the DATAform folder is incorrect. (See under message system.)
Error -2 = timeout, $5 was = 0, the answer was not waited for.
Error -3 = timeout, wait loop interrupted by user.
Error -4 = timeout, the confirm dialogue was canceled.
Error -10 = the command, parameter $1, is missing.
Error -11 = the path to the DATAformTags file $2 is missing.
Error -12 = the path to the QuarkXPress folder $4 is missing.
Error -13 = fewer than 6 arguments were transferred.
Error -20 = the message file could not be created.
Error -21 = the message could not be placed in the input folder Eingang.
Error -30 = the process could not be started.
Error -40 = a message was received, but could not be read.
>0
The response of the DATAformXTension was received and contains an error value >0.
DATAformXTension simultaneously sends an error text with the response. The text is
transferred in $6=>. A list of error messages from 65537 to 65590 may be found in the
appendix.
How it works
Implementing the message system in your 4D application, demonstrating a “automatic box
height calculation”.
Create a new procedure, e.g. CalcBoxes.
CalcBoxes contains the following three steps:
1) Start QuarkXPress
Check manually or via a method:
- If QuarkXPress is open. If not start QuarkXPress.
- If the QuarkXPress document exists into which you wish to place.
Or start QuarkXPress manually with the document. Make sure that the settings in QuarkXPress
“Include XPressTags” are appropriate for your needs. Turn the server activity in DATAformX-
Tension to ON.
2) Create the DATAformTag file
MyExport
`This is your export method, it creates e.g. the document
`„DATAform.QXP“ in the QuarkXPress:DATAform folder.
In this method you set the DATAformTag DX_Array {60} *D to the desired value, e.g.:
DX_Array {60} := "1"
Check the success of the export: The file DATAform.QXP was created.
herunterladen