ImageGear Professional > API Reference Guide > ART Component API Reference > ART Component Functions Reference > Group Functions > ART_group_visible |
This function sets the visibility (hide or show) of all of the marks in the group identified by szGroupName.
Copy Code
|
|
---|---|
AT_ERRCOUNT ART_group_visible(
HIGEAR hIGear,
const LPSTR szGroupName,
BOOL fVisible
);
|
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. |
Returns the number of ImageGear errors that occurred during the function call.
All pixel formats supported by ImageGear Professional.
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); |
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: