IG_ARTX_text_pin_get

API Reference Guide / ArtX Component API Reference / ArtX Component Objects Reference / HIG_ARTX_TEXT / IG_ARTX_text_pin_get

Collapse All

In This Topic

IG_ARTX_text_pin_get

In This Topic

This function queries the annotation pin.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_ARTX_text_pin_get( HIG_ARTX_TEXT hMark, LPAT_ARTX_PIN lpPin, LPAT_UINT pnDataSize );

Arguments:

Name	Type	Description
hMark	HIG_ARTX_TEXT	Annotation handle.
lpPin	LPAT_ARTX_PIN	Pointer to storage that is overwritten with the pin value.
pnDataSize	LPAT_UINT	Pointer to the variable that on input contains size of buffer specified by lpPin parameter. On output it contains number of bytes copied to lpPin 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 the annotation has a pin, then it is copied into output buffer lpPin and number of bytes copied is placed into pnDataSize.
If lpPin is NULL and pnDataSize is not NULL, then on output pnDataSize contains the size of AT_ARTX_PIN structure.
If lpPin is not NULL and pnDataSize is not NULL and there is no pin for this annotation, then on output pnDataSize contains zero.
See AT_ARTX_PIN structure for additional info.

©2025 Accusoft Corporation. All Rights Reserved.

Get Product Support