Menus

Description

Display a dropdown menu.

Used with the Grid and UX components.

 Menu Choices Properties

Method for defining menu

Specify how the menu will be defined. If the menu choices are not dynamic, then you can use the 'Menu Builder' or 'Static JSON String'. If you want the choices to be dynamic, use Xbasic function. Choices include Menu Builder, Static JSON String, Xbasic Function.

Static JSON String

Specify the JSON menu definition.

Menu definition

Define the menu choices

Xbasic function

Specify the name of the Xbasic function to call to generate the menu choices

Javascript function

Specify the name of the Javascript function to call to generate the menu choices

 Menu Properties Properties

Menu position

Specify where the menu will be shown.

Menu name

(Optional) Specify a name for the menu. If you specify a name you will be able to use Javascript to get a pointer to the menu object. You can leave this blank or use <Default> to use a system generated name. If you specify a name, it must be unique to this menu.

Icon column width

Specify the width of the icon column. This is the column to the left of the menu choices where optional menu icons are shown.

Has pointer icon

Specify if the window has a pointer icon that points to the element that was clicked to show the window.

Pointer position

Specify the window edge that has the pointer icon. If you select 'Auto' the most appropriate edge is automatically selected. Choices include Auto, Top, Bottom, Left, Right.

 Menu Animation Properties

Animation

Specify if the window should be animated when it is shown or hidden.

Show animation style

Select the animation method to use when the window is shown. Fade and Slide use methods in jQuery core. Other options require jQueryUI.

Show animation speed

Specify the animation speed. You can select a pre-defined option (slow = 600 milliseconds, fast = 200 milliseconds), or you can enter an explicit value in milliseconds.

Hide animation style

Select the animation method to use when the window is closed. Fade and Slide use methods in jQuery core. Other options require jQueryUI.

Hide animation speed

Specify the animation speed. You can select a pre-defined option (slow = 600 milliseconds, fast = 200 milliseconds), or you can enter an explicit value in milliseconds.

 Javascript

{grid.componentName}_G__1(this);

 Create a Dropdown Action:

  1. Click the button next to the Menu Definition Property

  2. Create a list of choices for the dropdown using the Tree Data Genie.

  3. Javascript Functions page click on the Action Javascript genie and add the dropdown action to the component.

    {grid.object}.runAction('dropdown');
  4. Dropdown list in Working Preview

See Also