I. DATAformXTension
DATAform/Import boxes
This command reads a text with DATAformTags and creates the appropriate objects. Text
boxes, picture boxes or lines can be imported. The text is loaded from the clipboard or from a
file, as set in the preferences dialogue. (See Preferences..., page: 23.)
Checking for uniqueness
If an object description contains an object ID (shown by the Tag *#), then the QuarkXPress
document is checked to see if a box with this ID number already exists.
If a box exists with this box ID number, then a dialogue is shown and the box can be replaced
or overwritten.
Copy the following text
¶*#111*T3*x100*X200*y100*Y150*$My first box¶
and create the box.
Create the box again with the command Import box, the following dialogue will appear:
Box Nº. 111 just created by *#111 already exists.
Cancel
The complete import procedure is cancelled.
Skip
The box is not imported; the procedure skips this object and proceeds with the next object.
Replace
The existing box is deleted and the new box will be created.
The new box is created at the position and the page, as defined by its Tags. Its properties are
independent of the properties of the previously deleted box.
If the object number is *#0 or if the Tag is missing, there is no check to see whether the box
already exists, the object will always be created.
Import picture boxes and loading pictures
If the text with DATAformTags describes a picture box with a path to a picture, then
DATAformXTension will search for the picture and place it in the box. If the supplied path is a
complete picture path, it looks for the picture at this location then in the document folder and
finally in the QuarkXPress folder. (See under DATAformTags {1} *$ Text/path, page: 32)
If the picture is found, QuarkXPress will load it as if it had been placed manually.
DATAformXTension passes the path to the picture after checking it onto QuarkXPress; Quark-
XPress itself then loads the picture. All QuarkXPress picture formats or OPI functions are
available.
If the picture is not found, you have the possibility to load it manually.
¶*#2*T13*x100*X200*y100*Y150*$My false path¶
If you import this text with DATAformTags, DATAform expects, due to *T13, a picture path
after *$.
15
Developer handbook DATAformXTension © 1992-2004 www.gassenhuber.de