Setting and requesting file information

 

Through the API, you can request or set file options, such as a file name or a label, for complete documents or for individual pages and layers.

image\tip_shg.gif Tip: Pages and layers in multipage and multilayer documents

To request or assign a file name to a document, page, or layer:

· Use the IN_GetFilename and the IN_SetFilename functions. Specify a document window ID, document ID, page ID, or layer ID as the objectID.

To request or assign a label to a document, page, layer, or CAD layer:

· Use the IN_GetTitle and the IN_SetTitle functions. Specify a document ID, page ID, or layer ID as the objectID.

Each returns or sets a text string that contains a maximum of 81 bytes.

You can also request the file size of an Imagenation entity.

To request the file size of a document, page, or layer:

· Use the IN_GetObjectFileSize function. Specify a document window ID, document ID, page ID, or layer ID as the objectID.

The file size of the specified object is returned.

For CALS and TIFF rasters, you can request or set an information (or comment) string that only appears in the raster file's header by using the IN_GetRasterInfoString and the IN_SetRasterInfoString functions.

See also

Defining default open and save directories

Defining the default symbol directory