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

    This function pastes one or more marks from the clipboard to the top of the current HIGEAR image.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ART_edit_paste(
            HIGEAR hIGear, 
            HWND hWnd, 
            DWORD dwGrpID
    );
    

    Arguments:

    Name Type Description
    hIGear HIGEAR HIGEAR handle to the image.
    hWnd HWND HWND handle to the window.
    dwGrpID DWORD Identifier of group.

    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:

    Annotation

    Example:

     
    Copy Code
    HIGEAR hIGear; /* HIGEAR handle of image */
    AT_ERRCOUNT nErrcount; /* tally of IG errors on stack */
    DWORD dwMarkCount; /* # of marks available  */
    /* for paste  */
    HWND hWnd; /* Windows handle to  */
    /* image window  */
    DWORD dwGrpID;
    nErrcount = ART_edit_paste_count(hIGear, &dwMarkCount);
    if (dwMarkCount > 1) 
    {
    dwGrpID = IG_GRP_DEFAULT;
    nErrcount = ART_edit_paste(hIGear, hWnd, dwGrpID);
    nErrcount = ART_GUI_mark_paint(hIGear, dwGrpID, 
    ART_INVALID_ID, hWnd, TRUE);
    }
    

    Remarks:

    The pasted marks are not visible until the screen is repainted. Use ART_GUI_mark_paint() function.

    An error is set if any of the following conditions are met: