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

This function changes the attributes of a mark.

Declaration:

 
Copy Code
AT_ERRCOUNT ART_mark_modify(
        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 A far pointer to a structure of type ART_MARK_ATTRIBUTES that holds all settings for the mark's attributes.

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 */
ART_MARK_ATTRIBUTES ma;  /* mark attributes */
/* structure */
ART_MARK_INDEX markIndex /* index to the mark */
ART_mark_selected_first(hIGear, &hMarkIndex);
if (hMarkIndex != ART_MARK_INVALID)
{
ART_mark_query(hIGear, markIndex, &ma);
ma.dwType = 506;  /* arrow    */
ma.dwLineSize = 5;  /* line thickness =  */
/* 5 pixels    */
nErrcount = ART_mark_modify(hIGear, markIndex, &ma);
}

Remarks:

The attributes are stored in a structure of type ART_MARK_ATTRIBUTES, that is defined in ARTAPI.H. You can set any number of the attributes of this structure and then pass it to this function.

The mark is repainted in order to see the change in its attributes. Use ART_GUI_mark_paint() function.

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