gui_ButtonsPanel.adoc

ButtonsPanel

LIVE DEMO

API DOCS

ButtonsPanel is a container that streamlines the use and placement of the components (usually, buttons) for data management in a table.

XML-name of the component: buttonsPanel.

A sample definition of ButtonsPanel in screen XML-descriptor:

link:../../../../../../source/gui_vcl/buttonspanel_1.xml[role=include]

buttonsPanel element can be located either inside a table, or in any other place of a screen.

If the buttonsPanel is located in a table, it is combined with the table’s rowsCount component thus using vertical space more effectively. Additionally, if a lookup screen is opened using Frame.openLookup() (for example, from the PickerField component) the buttons panel becomes hidden.

Tip	The caption of buttonsPanel located inside the list component ([gui_Table], [gui_TreeTable], [gui_GroupTable], [gui_DataGrid], [gui_TreeDataGrid], [gui_Tree]) is ignored. Only the list component caption is displayed.

alwaysVisible attribute disables panel hiding in a lookup screen when it is opened by Frame.openLookup(). If the attribute value is true, the buttons panel is not hidden. By default, the attribute value is false.

Clicks on the buttonsPanel area can be intercepted with the help of the LayoutClickListener interface.

You can use keyboard shortcuts in ButtonsPanel. Set the shortcut and the action to be performed using the addShortcutAction() method:

link:../../../../../../source/gui_vcl/buttonspanel.java[role=include]

---

Attributes of buttonsPanel

align - alwaysVisible - caption - captionAsHtml - contextHelpText - contextHelpTextHtmlEnabled - css - description - descriptionAsHtml - enable - expand - box.expandRatio - height - id - stylename - visible - width

API

addLayoutClickListener - addShortcutAction - setSpacing

---