This function moves a mark to the front of the stacking order.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ART_mark_bring_to_front(
HIGEAR hIGear,
ART_MARK_INDEX hMarkIndex
);
|
|
Arguments:
| hIGear | HIGEAR handle to the image. |
| hMarkIndex | Mark identifier. |
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 */ AT_ERRCOUNT nErrcount; /* tally of IG errors */ /* on stack */ ART_MARK_INDEX hMarkIndex /* index for mark to */ /* bring to front */ nErrcount = ART_mark_selected_first(hIGear, &hMarkIndex); if (hMarkIndex != ART_MARK_INVALID) { nErrcount = ART_mark_bring_to_front(hIGear, hMarkIndex); } |
|
Remarks:
 |
The mark must be repainted in order to see a change in the stacking order. 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.
- There are no marks with a matching index block.
To move a group of marks to the front, use ART_group_bring_to_front().