typedef struct tagANNFILEINFO
{
L_UINT uStructSize;
L_SSIZE_T nOffset;
L_INT32 nVersion;
L_UINT uFormat;
L_INT32 nTotalPages;
L_INT32 nReserved;
} ANNFILEINFO, * pANNFILEINFO;
The ANNFILEINFO structure contains information retrieved from a LEAD annotation file.
Member |
Description |
|
uStructSize |
Size of the structure. This must be set before passing this structure to the LEAD functions. |
|
nOffset |
Position of the first byte to load. This must be set before passing this structure to the LEAD functions. Typically, this is set to 0. |
|
nVersion |
Version of the annotation file. If '12' is returned, this refers to version 12 or earlier. |
|
uFormat |
Flag that indicates the format of the annotation data in the file. Possible values are: |
|
|
Value |
Meaning |
|
ANNFMT_EMF |
Windows EMF format. |
|
ANNFMT_ENCODED |
LEAD binary format. This file size is smaller and is upward compatible. It also provides better security. |
|
ANNFMT_NATIVE |
LEAD text-based format for annotations. |
|
ANNFMT_WMF |
Windows WMF format. |
|
ANNFMT_XML |
XML text format. This is LEAD©s new text-based format which is upward-compatible. |
nTotalPages |
The total number of pages in the annotation file. |
|
nReserved |
Reserved for future use. Pass 0. |
Comments
The ANNFILEINFO structure is updated by the L_AnnFileInfo, L_AnnFileInfoMemory and L_AnnFileInfoOffset functions with information about an annotation file. Before passing this structure to any of the LEAD functions, the nSize and nOffset fields must be filled.
Some functions which take this structure as a parameter require that the structure be initialized prior to the function call. You must set the uStructSize member to the total size, in bytes, of the structure. Use the sizeof() macro to calculate this value. Functions that do not require the structure be initialized will take the total size of the structure, in bytes, as an additional function parameter.