This function queries the text callout.
Declaration:
|
Copy Code
|
AT_ERRCOUNT ACCUAPI IG_ARTX_text_callout_get(
HIG_ARTX_TEXT hMark,
LPAT_ARTX_CALLOUT lpCallout,
LPAT_UINT pnDataSize
);
|
Arguments:
Name |
Type |
Description |
hMark |
HIG_ARTX_TEXT |
Annotation handle. |
lpCallout |
LPAT_ARTX_CALLOUT |
Pointer to storage that is overwritten with the current text callout value. |
pnDataSize |
LPAT_UINT |
Pointer to the variable that on input contains size of buffer specified by lpCallout parameter. On output it contains number of bytes copied to lpCallout buffer. |
Return Value:
Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.
Supported Raster Image Formats:
This function does not process image pixels.
Remarks:
- If text callout is specified for the annotation, then it is copied into output buffer lpCallout and number of bytes copied is placed into pnDataSize.
- If lpCallout is NULL and pnDataSize is not NULL, then on output pnDataSize contains the size of AT_ARTX_CALLOUT structure.
- If lpCallout is not NULL and pnDataSize is not NULL and there is no text color in the annotation, then on output pnDataSize contains zero.
- See AT_ARTX_CALLOUT structure for additional info.