CygNet Studio > Using TheFrame/TheView > Adding Context Menus > Custom Context Menus

Custom Context Menus

Custom Context menus are supported by the CygNet ActiveX controls listed below. The properties to configure the custom menus are located in the (OCXproperties) for each control. The only items that are different about each of the custom controls are the options to disable a menu item if certain conditions are not met. All other options on creating the menu options are the same as the standard context menu items.

Currently, the following CygNet ActiveX controls support custom context menus:

To specify the custom context menu configuration for a control, invoke the Custom Context Menu Configuration dialog box from the control’s OCXProperties field on the ActiveX page of the Property Sheet:

Custom Context Menu Configuration

Each custom context menu item has a text description (Item Text), which will appear in the context menu pop-up, and an Event ID that will identify a specific item when handled by the EventOnContextMenu event. Event IDs therefore must be unique. This information is then stored in the ContextMenuXml property on the ActiveX page of the control’s Property Sheet.

When an item is selected in the pop-up menu, the EventOnContextMenu event is fired and can be caught via script. The event will be given at least the Event ID. In the case of the grid-based ActiveX controls (Event Summary, Group Grid, and CAS View controls), it will also be given the row and column for the cell on which the menu was invoked.

Control Specific Options

The following properties are specific to the individual ActiveX controls.

CAS View Control

The button to configure the Context menu options for the CAS View Control is located on the General page of the OCX Properties.

Property Description

Disable if alarm unacknowledged

Disables the custom menu item from running if the selected alarm is in unacknowledged state.

Disable if alarm acknowledged

Disables the custom menu item from running if the selected alarm is in an acknowledged state.

Event Summary Control

The button to configure the Context menu options for the Event Summary Control is located on the Misc page of the OCX Properties.

Property Description

Disable if no Facility

Disables the custom menu item from running if no facility is available.

Disable if no point

Disables the custom menu item from running if no point is available.

Group Grid Control

The button to configure the Context menu options for the Group Grid Control is located on the General page of the OCX Properties.

Property Description

Disable if Tag not Valid

Disables the custom menu item from running if the Selected Tag is not valid.

Group Tree Control

The button to configure the Context menu options for the Group Tree Control is located on the Properties page of the OCX Properties.

Property Description

Disable if no Facility

If Disable if no Facility is enabled, the custom context menu item will not appear if there is NO facility available for the selected node.

Disable if facility

If Disable if Facility is enabled, the custom context menu item will not appear if there IS a facility available for the selected node.

Back to top

Let us know how we can improve this topic.

CygNet at weatherford.com

© 2020 Weatherford. All rights reserved.