ImageGear for C and C++ on Windows v19.1 - Updated
ART_mark_bring_to_front
API Reference Guide > ART Component API Reference > ART Component Functions Reference > Mark Management Functions > ART_mark_bring_to_front

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:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
hMarkIndex ART_MARK_INDEX 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 for C and C++.

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:

To move a group of marks to the front, use ART_group_bring_to_front().