ImageGear for C and C++ on Windows v19.4 - Updated
ART_group_visible
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.

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: