Setting the hiShowContextMenuCallback Property

With the hiShowContextMenuCallback property, you can specify a callback to be invoked just before the context menu is displayed.

To set the hiShowContextMenuCallback property, use the following command:

hiFormHandle->hiFieldSymbol->hiShowContextMenuCallback=S_value

hiFormHandle is the handle to the form returned by hiCreateAppForm. hiFieldSymbol is the symbol of the field, set with the ?name argument when the field was created. S_value is a symbol or string specifying the callback function to be invoked. If you specify S_value as a string, the string is evaluated and no arguments are passed to the callback function. If you specify S_value as a symbol, the callback function is passed certain arguments; these arguments can vary depending on the type of field on which the property is being set. The following table lists the arguments for different fields:

Field	Arguments passed to context menu callback function
Tree Table	(r_menu g_formOrRegion s_field s_item)
Other fields	(r_menu g_formOrRegion s_field)

where
r_menu is the value of the hiContextMenu property;
g_formOrRegion is either a form (of type r) if the field is placed at the top level of the form, that is, it is not within a scroll region or tab page; a scroll region (of type o); or a tab page (of type o);
s_field is the symbol of the field;
s_item is the symbol of the tree table item which is right-clicked.

Related Topics

Creating Tool Tips for Fields

Setting the hiContextMenu Property

Return to top