ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / ART Component API Reference / ART Component Functions Reference / File Functions / ART_file_append
In This Topic
    ART_file_append
    In This Topic

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