This function sets a Usage dictionary entry in a layer object.
Declaration:
Copy Code | |
---|---|
AT_ERRCOUNT ACCUAPI IG_PDF_layer_set_usage_info( HIG_PDF_LAYER hLayer, HIG_PDF_ATOM hUsageKey, HIG_PDF_BASOBJ hUsageInfo ); |
Arguments:
hLayer | Layer object whose usage information is set. |
hUsageKey |
The usage key in the usage dictionary entry. Possible key values are:
|
hUsageInfo | The usage information to associate with the key. |
Return Value:
Error count.
Supported Raster Image Formats:
This function does not process image pixels.
Remarks:
The entry associates usage information with an entry key for retrieval. If a dictionary does not exist, the method creates one.
A Usage dictionary entry provides more specific intended usage information than an intent entry.
The usage value can act as a kind of metadata, describing the sort of things that belong to the layer: for example, text in French, fine detail on a map, or a watermark. The usage values can also be used by the AutoState mechanism to make decisions about what layers should be on and what layers should be off.