ART_edit_paste

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

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:

hIGear does not reference a valid ImageGear handle.