IN_GetTitle

All Editions image\bltlrgsq_shg.gif Related Functions  image\bltlrgsq_shg.gif Example

The IN_GetTitle function returns the label of the specified document window, document, page, layer, or CAD layer. A label is a text string that is associated with each symbol, layer, page, or multipage as it is saved. It can be up to 80 characters long and can include spaces.

Syntax

int IN_GetTitle( objectID, maxSize, pLabel )

Input Parameters

Meaning

IN_OBJECT objectID

identifier of the document, page, layer, or CAD layer to query

SHORT maxSize

the maximum size of the pLabel array, which must be a minimum of 81 bytes

Output Parameters

Meaning

CHARPTR pLabel

pointer to the label string

Release information

Added to Imagenation for Windows in Release 4.10.

As of Release 5.1, also available in Imagenation for UNIX.

Also supported in Imagenation 3.3 for UNIX.

See also

Setting and requesting file information

Defining window titles