ImageGear for C and C++ on Linux v18.8 - Updated
ART_mark_selected_first
API Reference Guide > ART Component API Reference > ART Component Functions Reference > Mark Management Functions > ART_mark_selected_first

This function returns the index of the mark that is first in the list of selected marks.

Declaration:

 
Copy Code
AT_ERRCOUNT ART_mark_selected_first(
        HIGEAR hIGear, 
        LPART_MARK_INDEX lpMarkIndex
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
lpMarkIndex LPART_MARK_INDEX A far pointer that returns the index of the first mark selected.

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++.

Example:

 
Copy Code
HIGEAR hIGear; /* HIGEAR handle of image */
. . .
case ID_EDIT_DELETE:  /*delete all marks   */
ART_mark_selected_first(hIGear, &hMarkIndex);
/* iterate through all marks that were selected by user 
and delete them */
while (hMarkIndex != ART_INVALID_ID)
{
hMarkDelete = hMarkIndex;
ART_mark_selected_next(hIGear, &hMarkIndex);
ART_mark_delete(hIGear, hMarkDelete);
}

Remarks:

ART_mark_selected_next() returns the index of the next mark.