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.