ART_group_edit

This function copies a group of marks to the clipboard.

Declaration:

	Copy Code
AT_ERRCOUNT ART_group_edit_copy( HIGEAR hIGear, const LPSTR szGroupName );

Arguments:

Name	Type	Description
hIGear	HIGEAR	HIGEAR handle to the image.
szGroupName	const LPSTR	A far pointer to a NULL-terminated string that contains the group of marks to copy to the clipboard.

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++.

Example:

	Copy Code
HIGEAR hIGear; /* HIGEAR handle of image / char FAR szGroupName; /* name of group from / / which to copy mark / AT_ERRCOUNT nErrcount; / tally of IG errors / / on stack / / Copy the Sticky Notes Group to the clipboard */ szGroupName = "Sticky Notes Group"; nErrcount = ART_group_edit_copy(hIGear, szGroupName);

Copy Code

HIGEAR hIGear; /* HIGEAR handle of image */
char FAR *szGroupName; /* name of group from */
/* which to copy mark */
AT_ERRCOUNT nErrcount; /* tally of IG errors */
/* on stack  */
/* Copy the Sticky Notes Group to the clipboard */
szGroupName = "Sticky Notes Group";
nErrcount = ART_group_edit_copy(hIGear, szGroupName);

Remarks:

Use szGroupName to tell ART which group of marks to copy.

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

hIGear does not reference a valid ImageGear handle.
No group matches szGroupName.