This function moves a group of marks to the back of the stacking order.
Declaration:
|
Copy Code
|
AT_ERRCOUNT ART_group_send_to_back (
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 name of the mark 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:
None
Example:
|
Copy Code
|
HIGEAR hIGear; /* HIGEAR handle of image */
char FAR *szGroupName; /* Name of group to bring */
/* to front */
nErrcount = ART_group_send_to_back(hIGear, szGroupName);
|
Remarks:
An error is set if any of the following conditions are met:
- hIGear does not reference a valid ImageGear handle.
- No group matches szGroupName.