This function moves a group of marks to the back of the stacking order.

Declaration:

AT_ERRCOUNT ART_group_send_to_back (
        HIGEAR hIGear, 
        const LPSTR szGroupName
); 

Arguments:

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:

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.