IV. Message system
112
Developer handbook DATAformXTension © 1992-2004 www.gassenhuber.de
If you use the DATAform 4D interface, the command DX_Message deals with the message
files instead: DX_Message creates the message, waits for the answer and evaluates it. (See
under DATAform 4D interface.)
The procedures of the 4D interface are also as a text file part of the DATAform developers
kit and may be used as a coding template in other systems.
Messages and functional objects
The transferred text with DATAformTags may also contain functional objects.
DATAformTag Text without functional objects
-
The DATAform setting Group is used upon import if the check box is set to ON.
-
Existing boxes within the document with the same object number will be skipped upon
import; the duplicate dialogue with the message the box number already exists will not
appear.
-
Likewise if boxes are not found when updating the content, they will be skipped without a
message.
-
If a picture is not found, the empty picture box is created. The load picture dialogue will not
appear.
Example: The file DATAformImport.txt contains this text with DATAformTags, Group in the
preferences is OFF.
¶*T3*G1*#1*$Text¶*x110*X210*T12*G1*#2*$False picture path¶
One text and one picture box are imported, no load picture dialogue appears, the boxes will not
be grouped.
DATAformTag Text with functional objects
The settings in the preferences dialogue can be overwritten via functional objects:
¶*T106*M1*$¶*T101*M1*$¶*T3*G1*#1*$Text¶*x110*X210*T12*G1*#2*$False picture
path¶*x220*X320*T12*G1*#3*$False picture path 2¶
-
The boxes will now always be grouped by *T106*M1. By *T101*M1 the load picture dia-
logue will appear with non found pictures.
All functional objects may be part of the text with DATAformTags even if it is imported by the
message system.
Functional objects here also have priority over the command SUBJECT:
Example: The message contains SUBJECT:IMPORT
The DATAformTag however, reads:
¶*T102*M1*$¶*T3*G1*#1*$Text¶
*T102 switches the processing mode to update, the following boxes are therefore not imported,
but DATAformXTension tries to update existing boxes.