ImageGear for C and C++ on Windows v19.1 - Updated
ART_file_import_ex
API Reference Guide > ART Component API Reference > ART Component Functions Reference > File Functions > ART_file_import_ex

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:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
hWnd HWND HWND handle to the window.
dwGrpID DWORD Identifier of group.
lpszFileName const LPSTR A far pointer to the name of the .ART file to import.
dwPageNumber DWORD 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 BOOL 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 for C and C++.

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).