Avatar

Level 10

importDataObject

Imports an external file into the document and associates the specified name with the data object. Data objects can later be extracted or manipulated.

Related objects, properties, and methods are dataObjects, getDataObject, openDataObject, createDataObject, exportDataObject, removeDataObject, getDataObjectContents, and setDataObjectContents, and the Data Object.

NOTES:(SecurityS): If the cDIPath parameter is specified, this method can only be executed during batch, console or menu events, or through an external call (for example, OLE). See “Privileged versus Non-privileged Context” on page 34 for details. See the event Object for a discussion of Acrobat JavaScript events.

When a file attachment is imported using importDataObject, the value of its Data.name is assigned by the parameter cName. However, when a file is attached using the UI, its name is automatically assigned. The attachments are assigned the sequential names “Untitled Object”, “Untitled Object 2”, “Untitled Object 3”, and so on.

Returns

true on success. An exception is thrown on failure.

Example

this.importDataObject("MyData");

-Nith