Difference between revisions of "Section Menus"
Yvonne.milne (Talk | contribs) |
Yvonne.milne (Talk | contribs) |
||
Line 206: | Line 206: | ||
!width="80%"|Notes | !width="80%"|Notes | ||
|- | |- | ||
− | |valign="top"|Visible|| | + | |valign="top"|Visible||Lianja.getElementByID("page.section").menuVisible is exposed on the Desktop client only (Lianja/VFP). (From v1.3.1). |
|- | |- | ||
|valign="top"|Height||- | |valign="top"|Height||- | ||
Line 214: | Line 214: | ||
|valign="top"|Foreground color||The Foreground color is supported on the Desktop client only. | |valign="top"|Foreground color||The Foreground color is supported on the Desktop client only. | ||
|- | |- | ||
− | |valign="top"|Custom menu||The | (center), > (align right) and < (align left) prefixes are available on the Desktop client only.<br>The # prefix is available on all clients and on non Desktop clients the menu items will be displayed as buttons.<br>Non-prefixed menu item lists are aligned left.<br> | + | |valign="top"|Custom menu||The | (center), > (align right) and < (align left) prefixes are available on the Desktop client only.<br>The # prefix is available on all clients and on non Desktop clients the menu items will be displayed as buttons.<br>Non-prefixed menu item lists are aligned left.<br>Lianja.getElementByID("page.section").menu is exposed on the Desktop client only (Lianja/VFP). |
|- | |- | ||
|valign="top"|Custom action||The Custom action is supported on the Desktop client only. | |valign="top"|Custom action||The Custom action is supported on the Desktop client only. |
Revision as of 06:51, 13 April 2015
Sections can have a Menu displayed under their header. Menus can have a single level pulldown.
Double-click on the Section header or click the cog icon to access the Section Attributes. Scroll down to the Menu sub-section.
For Footer Menus, see Section Footers.
Contents
Visible
By default, the Section Menu is not visible.
To make the Section Menu visible, check the Visible attribute to True.
The Visible attribute can be queried or changed programmatically using Lianja.getElementByID("page.section").menuVisible.
Height
The Height attribute is used to specify the Section Menu height.
Background color
The Background color is used to specify the menu background color.
Click the [...] button to access the 'Select Color' dialog.
Foreground color
The Foreground color is used to specify the menu foreground color.
As above, click the [...] button to access the 'Select Color' dialog.
The menu is specified as a comma-separated list of menu items. By default, the menu items are left-aligned.
To display the menu items right-aligned, prefix the list of values with >.
Note: a < can be used for left-alignment (also the default).
To display the menu items centered, prefix the list of values with |.
The # prefix will also center the menu items on the Desktop Client.
On Web/Tablet/Mobile clients, the # prefix will display the menu items as centered buttons.
Menu items can have a single-level pulldown. The pulldown items are | separated and enclosed in parentheses.
Menu items with a pulldown are displayed with a down arrow to the right of the item text. Click the arrow to display the pulldown and then select an item.
The Custom menu attribute can be queried or changed programmatically using Lianja.getElementByID("page.section").menu.
Custom action
When a menu item is selected, the action specified in the Custom action attribute will be performed.
The action is a SHOWDOCUMENT() action.
The selected menu item can be accessed via {}.
If no Custom action is specified, the Custom section menu Custom Delegate will be run if set.
If no Custom action is specified, the Custom section menu Custom Delegate will be run when a menu item is selected.
This can be a single line inline delegate.
The selected menu item can be accessed via {}.
Or it can be the name of the script function to be called. The selected menu item text is passed to the function as a parameter ('selitem' in the examples below).
Click the [...] button to create and edit the script function. The Section Scripting Language attribute determines the language used.
Lianja/VFP function example
//////////////////////////////////////////////////////////////// // Event delegate for 'customsectionmenu' event proc employees_section1_customsectionmenu(selitem) do case case selitem = "page2" messagebox("You selected page2") case selitem = "page3" messagebox("You selected page3") otherwise messagebox("You selected page4") endcase endproc
JavaScript function example
//////////////////////////////////////////////////////////////// // Event delegate for 'customsectionmenu' event function employees_section1_customsectionmenu(selitem) { if (selitem == "page2") { messagebox("You selected page2"); } else if (selitem == "page3") { messagebox("You selected page3"); } else { messagebox("You selected page4"); } };
Notes on Client Support
Attribute | Notes |
---|---|
Visible | Lianja.getElementByID("page.section").menuVisible is exposed on the Desktop client only (Lianja/VFP). (From v1.3.1). |
Height | - |
Background color | The Background color is supported on the Desktop client only. |
Foreground color | The Foreground color is supported on the Desktop client only. |
Custom menu | The | (center), > (align right) and < (align left) prefixes are available on the Desktop client only. The # prefix is available on all clients and on non Desktop clients the menu items will be displayed as buttons. Non-prefixed menu item lists are aligned left. Lianja.getElementByID("page.section").menu is exposed on the Desktop client only (Lianja/VFP). |
Custom action | The Custom action is supported on the Desktop client only. |
Custom section menu | The Custom delegate script function must be written in JavaScript for non Desktop clients. Using an inline delegate is supported on the Desktop client only. |