This function sets the access control (editable or view only) for all of the marks in the group specified by szGroupName.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ART_group_access(
HIGEAR hIGear,
const LPSTR szGroupName,
BOOL fEnable
);
|
|
Arguments:
| hIGear | HIGEAR handle to the image. |
| szGroupName | A far pointer to a null-terminated string that tells ART which group of marks' access to change. |
| fEnable | A flag of type BOOL that tells ART whether to allow editing for all the marks in the group specified by szGroupName. |
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 */ char FAR *szGroupName; /* type of group to make */ /* accessible */ /* Deny access to the MIS Group */ szGroupName = "MIS Group"; nErrcount = ART_group_access(hIGear,szGroupName,FALSE); |
|
Remarks:
When fEnable is set to TRUE, the end user can edit or modify marks in the group; when set to FALSE the end user cannot edit or modify marks in the group.
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.