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_query
In This Topic
    ART_mark_query
    In This Topic

    This function queries a mark for its attributes that are stored in the structure ART_MARK_ATTRIBUTES.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ART_mark_query(
            HIGEAR hIGear, 
            ART_MARK_INDEX hMarkIndex, 
            LPART_MARK_ATTRIBUTES lpMarkAttr
    );
    

    Arguments:

    Name Type Description
    hIGear HIGEAR HIGEAR handle to the image.
    hMarkIndex ART_MARK_INDEX Mark identifier.
    lpMarkAttr LPART_MARK_ATTRIBUTES Mark description.

    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 */
    AT_ERRCOUNT  nErrcount; /* tally of IG errors on  */
    /* the stack   */
    ART_MARK_INDEX hMarkIndex; /* index to the mark  */
    /* being queried  */
    ART_MARK_ATTRIBUTES ma ; /* structure holding the  */
    /* mark's attributes  */
    UINT arrowCount;  /* number of arrow marks  */
    /* assoc. with image  */
    /* Get index of first mark created */
    ART_mark_first(hIGear, &hMarkIndex, NULL);
    /* While there are valid index number, iterate through them and keep count of any arrow
    marks associated with the image */
    while (hMarkIndex != ART_INVALID_ID)
    {
    nErrcount = ART_mark_query(hIGear, hMarkIndex, &ma);
    if (ma.dwType = 506)
    {
    arrowCount++
    }
       nErrcount = ART_mark_next(hIGear,&HMarkIndex,NULL);
    }
    

    Remarks:

    The attributes for the mark associated with hMarkIndex are copied into lpMarkAttr, and can then be examined. To bring a particular mark to the front of the stacking order, use ART_mark_bring_to_front().

    An error is set if any of the following conditions are met: