V. DATAform database interface
131
Developer handbook DATAformXTension © 1992-2004 www.gassenhuber.de
3) Send a message to DATAformXTension
$err := DX_Message ( "IMPORTEXPORT" ; DFMText; XP-Doc ; XP; 5; =>myText )
` DFMText is the path to the file created by MyExport.
` XP-Doc is the path to the QuarkXPress document and may be "".
` XP is the path to your QuarkXPress folder.
` 5 Timeout; set the value relative to the import file size.
` myText now contains your timeout alert text. At the end it may contain an error text
` from DATAformXTension or the name of the created message file.
DX_Message creates a message file in the monitored input folder Eingang.
DATAformXTension receives the message, imports the file DFMText, adjusts the box heights
depending on *D to the text and exports the boxes again. The file DFMText is overwritten by
the exported new data.
Then DATAformXTension creates its answer file.
During this time DX_Message and your programme both wait.
DX_Message shows the wait dialogue. (The form "DX_Wait" or $8 in [DX_Table])
If the message is received, your programme continues executing from here. If the user clicks
on Cancel in the wait dialogue, $err will become -3, see above.
if ($err # 0 )
ShowError ($err)
`Your method processes the error and eventually indicates it etc.
else
MyImport
`Import the file DFMText path as usual and process the
`received new box parameters.
End if
Note further details in the header of the methods, especially DX_Message and DX_DemoMes-
sage.
If you are using 4D, see the DATAform 4D sample database, available for free at
www.gassenhuber.de. It uses DATAform interface and is supplied in compiled and not com-
piled form.