ImageGear Professional DLL v17.1 for Windows Accusoft
ART_file_import_ex
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > ART Component API Reference > ART Component Functions Reference > File Functions > ART_file_import_ex

Glossary Item Box

This function loads the marks from a separate .ART file into the HIGEAR image.

Declaration:

  Copy Code
AT_ERRCOUNT ART_file_import_ex(
        HIGEAR hIGear, 
        HWND hWnd, 
        DWORD dwGrpID, 
        const LPSTR lpszFileName, 
        DWORD dwPageNumber, 
        BOOL bAppend
);

Arguments:

hIGear HIGEAR handle to the image.
hWnd HWND handle to the window.
dwGrpID Identifier of group.
lpszFileName A far pointer to the name of the .ART file to import.
dwPageNumber Set this parameter to the page number to load if the .ART file has multiple pages. If the .ART file has one page, set this to 1.
bAppend If this parameter is TRUE, then current ART annotation will be simply added to the specified .ART file. Otherwise previous annotation in the file will be replaced by the current one.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear Professional.

Sample:

None

Remarks:

This is typically used for combining a newly loaded image with marks that were previously made and saved separately to an .ART file.

This function is the same as ART_file_import(), but has supplementary parameter bAppend that allows you to determine if current ART annotation should be simply added to the specified .ART file (TRUE), or replace the existing one (FALSE).

©2012. Accusoft Corporation. All Rights Reserved.