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

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

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