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 Professional.
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:
- hIGear does not reference a valid ImageGear handle.
- There are no marks with a matching index block.
- lpMarkAttr is an invalid address or has one or more invalid fields.