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 Professional.
Sample:
None
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); |
|
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.