In This Topic ▼

groupsRoles Property

Summary

Gets or sets the AnnGroupsRoles associated with this automation manager.

Syntax

TypeScript

JavaScript

Object.defineProperty(AnnAutomationManager.prototype, 'groupsRoles', 
	get: function(), 
	set: function(value) 
)

groupsRoles: AnnGroupsRoles;

The AnnGroupsRoles object to be associated with this automation manager. The default value is null.

Remarks

The following occurs when the value of GroupsRoles is not null:

The user ID of any annotation object added to a container will be updated if it was empty. This is performed by checking the value of AnnObject.UserId against an empty string or null, and if so, updating this value with AnnGroupsRoles.CurrentUser.
When performing hit-testing, objects that do not have the correct role will be ignored and cannot be hit-tested (and thus, selected by the automation). This is performed by calling AnnGroupsRoles.IsCurrentUserInRole with AnnOperationType.HitTestObjects and either allowing the hit-test or ignoring it if based on the method return value. This is done when HitTestPoint or HitTestRect is called.

AnnAutomationManager will automatically set the value of GroupsRoles to the AnnContainer.GroupsRoles of all the containers used in the system.

Requirements

Help Version 21.0.2021.6.30

Leadtools.Annotations.Automation Assembly