This function pastes a rectangular or non-rectangular clipboard image into the HIGEAR image that you specify.

Declaration:

AT_ERRCOUNT ACCUAPI IG_clipboard_paste_merge_ex(
        HIGEAR hIGear, 
        AT_PIXPOS nLeftPos, 
        AT_PIXPOS nTopPos
);

Arguments:

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

Indexed RGB – 1, 4, 8 bpp;
RGB – 24 bpp.

Example:

AT_ERRCOUNT nErrcount;
HIGEAR  hIGear;
BOOL    bNRpasteAvail;
AT_PIXPOS       xpos, ypos;
AT_MODE         nRegionType;
nErrcount = IG_clipboard_paste_available_ex(&bNRpasteAvail, &nRegionType);
nErrcount = IG_clipboard_paste_merge_ex(hIGear, xpos, ypos);

Remarks:

To check if there is a paste-able image on the clipboard, call IG_clipboard_paste_available_ex().

nLeftPos and nTopPos set the (x,y) coordinates of the upper-left corner of the bounding rectangle of the original image. See image below. The image has an (x,y) location within it at which the upper left-corner of the bounding rectangle will be placed. The white circle enclosed within a gray rectangle represents the non-rectangular ROI image stored in the clipboard, where the shaded area represents the transparent area between the bounding rectangle and the non-rectangular ROI. When the clipboard image is merged, only the circle will appear on the image.

Use IG_clipboard_paste_op_set() to tell ImageGear what kind of merge operation to perform.

This function will automatically call IG_clipboard_paste_available_ex() to confirm that there is data available. Therefore, it is not mandatory to call IG_clipboard_paste_available_ex() before making this call, unless you are interested in knowing the type of region contained in the clipboard.

©2016. Accusoft Corporation. All Rights Reserved.