Context Menu Customization
User interaction with the client-side PageView control is mostly performed using the context menu. The PageView control supports 14 modes listed in the MouseTool enumeration. Each mode allows the user to activate a context menu for a specific ART mark type listed in MarkType, or an image loaded into the control. The context menu customization API allows enabling an individual context menu for every combination of the MouseTool and ART mark type.
A context menu is an indexed array of items that are displayed on the screen when the user interacts with it. Any context menu item can be one of the following:
- Separator
- Popup
- Standard
- User
The Separator menu item is displayed on the screen as a horizontal line between the other context menu items. It is used for logical grouping of the items in the context menu.
The Popup menu item has text associated with the menu as well as a list of child items representing sub items and displayed when the user activates the popup in the context menu.
The context menu is designed as a tree of context menu items with ContextMenu as a non-leaf node and the leaf nodes performing the action. Any leaf node of the context menu can either represent a standard item or a user specific item. All context menus of the PageView control contain only standard items by default, but you can add any number of user items to any context menu using the customization API. Please refer to ContextMenuItemType and ContextMenuItem for details about the currently supported standard context menu items as well as the data structure of the context menu item.
The context menu can be hidden and shown using hideContextMenu and showContextMenu methods.
Context menu customization API provides the following API:
This API can be used to change, rename, or entirely reorganize the context menus.
This section provides information about the following: