ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / ART Component API Reference / ART Component Functions Reference / Mark Management Functions / ART_mark_selected_first
In This Topic
    ART_mark_selected_first
    In This Topic

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

    Sample:

    Annotation

    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.