Grouping Annotations

To enable application end-users to group annotation elements, the application program must set the AllowUserGrouping property to True. The AllowUserGrouping property sets or returns whether end users can create and destroy groups.

The default value of this property is False.

End user grouping actions are monitored by the application using events as follows:

Create a Group

The end-user selects multiple annotations by clicking within the bounding rectangle of the annotation and holding down the shift key. The end-user presses Ctrl-G to create a new group which includes each of the selected annotations. The new groups's yoked property is automatically set to True, allowing immediate user manipulation of the group. The UserGroupCreated event is raised to notify the application that a new group has been created.

Select a Group

The end-user selects a group by clicking within the bounding rectangle of a deselected group. A GroupSelected event is raised to notify the application.

Deselect a Group

The end-user de-selects a group by clicking again outside the bounding rectangle of a selected group. A GroupDeselected event is raised.

Destroy a Group

The end-user selects one or more groups to destroy. The end-user then presses Ctrl-U to destroy the selected group. The UserGroupDestroyed event is raised to notify the application that a group has been destroyed.