ImageGear for C and C++ on Windows v19.1 - Updated
IG_ARTX_image_reference_filename_get
API Reference Guide > ArtX Component API Reference > ArtX Component Objects Reference > HIG_ARTX_IMAGE_REFERENCE > IG_ARTX_image_reference_filename_get

This function queries the name of image file associated with hMark annotation.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ARTX_image_reference_filename_get(
        HIG_ARTX_IMAGE_REFERENCE hMark,
        LPSTR lpszTextBuffer,
        LPAT_UINT pnDataSize
);

Arguments:

Name Type Description
hMark HIG_ARTX_IMAGE_REFERENCE Annotation handle.
lpszTextBuffer LPSTR Pointer to buffer for output string.
pnDataSize LPAT_UINT Pointer to the variable that on input contains size of buffer specified by lpszTextBuffer parameter. On output it contains number of bytes copied to lpszTextBuffer buffer. If file name attribute is not empty in the annotation, then it is copied into output buffer lpszTextBuffer and number of bytes copied is placed into pnDataSize. If lpszTextBuffer is NULL and pnDataSize is not NULL, then on output pnDataSize contains the size required to store image file name. If lpszTextBuffer is not NULL and pnDataSize is not NULL and there is no image file in the annotation, then on output pnDataSize contains zero.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.