IG_clipboard_paste

This function retrieves compatible media from the clipboard, if available, and "places" or merges the clipboard media into the specified image at the specified coordinates.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_clipboard_paste_merge( HIGEAR hIGear, AT_PIXPOS nLeftPos, AT_PIXPOS nTopPos );

Arguments:

Name	Type	Description
hIGear	HIGEAR	HIGEAR handle of the image into which the clipboard media will be merged.
nLeftPos	AT_PIXPOS	X-coordinate of the hIGear to which the clipboard media will be merged.
nTopPos	AT_PIXPOS	Y-coordinate of the hIGear to which the clipboard media will be merged.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

C Clipboard, C Image Processing

Remarks:

The compatible data types supported on Windows systems are: CF_DIB, CF_BITMAP, CF_ENHMETAFILE, and CF_METAFILEPICT. Compatible data must be available on the clipboard for this API to be successful.

To determine the number of errors currently on the error stack use IG_error_check. After fetching all error information you need using IG_error_get, use IG_error_clear to clear the stack.