This function sets the visibility of a mark.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ART_mark_visible(
HIGEAR hIGear,
ART_MARK_INDEX hMarkIndex,
BOOL fVisible
);
|
|
Arguments:
| Name | Type | Description |
| hIGear | HIGEAR | HIGEAR handle to the image. |
| hMarkIndex | ART_MARK_INDEX | Mark identifier. |
| fVisible | BOOL | If set to TRUE, the mark is made visible; FALSE, invisible. |
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:
None
Example:
| Copy Code |
|
|---|---|
HIGEAR hIGear; /* HIGEAR handle of image */ AT_ERRCOUNT nErrcount; /* tally of IG errors on */ /* stack */ ART_MARK_INDEX hMarkIndex; /* index to current mark */ ART_MARK_ATTRIBUTES ma; /* structures for */ /* attributes of current */ /* mark */ nErrcount = ART_mark_query(hIGear, hMarkIndex, &ma); nErrcount = ART_mark_is_visible(hIGear, hMarkIndex, fVisible); if (fVisible == TRUE && ma.dwType == 10){ /* if an attach-a-note mark is visible */ nErrcount = ART_mark_visible(hIGear, hMarkIndex, FALSE); /* make it invisible */ } |
|
Remarks:
When fVisible is set to TRUE, the function show marks; when fVisible is set to FALSE, it hides marks. The bVisible field of the mark's attribute structure is set to the latest value for fVisible.
 |
The mark must be repainted in order to see a change in the visibility state. 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.