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

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

Declaration:

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

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
hWnd HWND HWND handle of the image window.
dwGrpID DWORD Display group.
lpszFileName const LPSTR A far pointer to the name of the .ART file to append.
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.

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

Example:

 
Copy Code
HIGEAR            hIGear;         /* HIGEAR handle of image */
char FAR          *szARTFile;      /* Name of the ART file  */
/* to import  */
char FAR          *szARTAppend;     /* Name of the ART file  */
/* to append  */
AT_ERRCOUNT        nErrcount;      /* Tally of IG errors on stack  */
HWND               hWnd;
nErrcount = IG_load_file("JoeFax.BMP", &hIGear);
nErrcount = ART_file_import(hIGear, szARTFile, 1);
nErrcount = ART_file_append(hIGear, hWnd, IG_GRP_DEFAULT, szARTAppend, 1);