This function sets the visibility (hide or show) of all of the marks in the group identified by szGroupName.
Declaration:
|
Copy Code
|
AT_ERRCOUNT ART_group_visible(
HIGEAR hIGear,
const LPSTR szGroupName,
BOOL fVisible
);
|
Arguments:
Name |
Type |
Description |
hIGear |
HIGEAR |
HIGEAR handle to the image. |
szGroupName |
const LPSTR |
A far pointer to a NULL-terminated string that identifies the name of the mark group to make visible. |
fVisible |
BOOL |
A flag of type BOOL that tells ART whether to make all of the marks in the group visible. If set to TRUE, all marks become visible. |
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:
None
Example:
|
Copy Code
|
HIGEAR hIGear; /* HIGEAR handle of image */
char FAR *szGroupName; /* type of group of marks */
/* to make visible */
HIGEAR hIGear; /* HIGEAR handle of image */
LPSTR szGroupName; /* data in global block */
DWORD dwBlockSize; /* size of block, in bytes */
AT_ERRCOUNT nErrCount; /* number of errors on the */
/* error stack */
nErrCount = ART_global_block_query(hIGear,
ART_BLOCK_GROUP, NULL, &dwBlockSize);
szGroupName = (LPSTR)alloca(dwBlockSize);
nErrCount = ART_global_block_query(hIGear, ART_BLOCK_GROUP, (LPVOID)szGroupName,
&dwBlockSize);
nErrcount = ART_group_visible(hIGear,szGroupName,TRUE);
|
Remarks:
The fVisible field of each of the mark's attribute structures will be set to TRUE or FALSE, depending on the fVisible parameter.
An error is set if any of the following conditions are met:
- hIGear does not reference a valid ImageGear handle.
- szGroupName does not point to a valid address.
- No group matches szGroupName.