Serna GUI Item Reference Guide

Table of Contents

1. GUI Item Table
2. GUI Items Detailed Description
ButtonGroup — ButtonGroup is a widget with a group of buttons.
ComboBox — ComboBox is a combined button and popup list.
ContextMenu — ContextMenu provides a context (popup) menu widget.
Dialog — Creates modeless and modal dialogs.
Document — Xml document instance interface
GridLayout — GridLayout lines up child items in a table manner.
GridWidget — GridWidget is a cell of GridLayout. Grid Widget is placed in its row and column of GridLayout according to the properties.
Label — Label is a text label with an optional outline and arbitrary background color.
Layout — Layout lines up child items horizontally or vertically.
LineEdit — LineEdit is a one-line text editor.
ListView — ListView provides a list/tree view.
ListViewItem — ListViewItem provides item for ListView.
MainMenu — MainMenu provides menu bar for MainWindow.
MainWindow — MainWindow of Serna Application.
MenuButton — MenuButton provides buttons (similar to ToolButton) suitable for MainMenu.
MenuItem — MenuItem provides menu item for MainMenu, PopupMenu and ContextMenu.
MenuSeparator — MenuSeparator inserts separator into menus. Is is suitable for PopupMenus andContextMenus.
PopupMenu — PopupMenu provides a popup menu widget. PopupMenu can have PopupMenu as a child.
PushButton — PushButton provides a command button, usually used in Dialog.
RadioButton — RadioButton provides a radio button with a text or label.
Splitter — Splitter provides splitter widget.
StatusBar — StatusBar is a horizontal bar at the bottom of MainWindow suitable for presenting status information.
Stretch —
TabWidget — Stack of tabbed items.
ToolBar — ToolBar - dockable tool panel containing widgets such as tool buttons.
ToolBarSeparator — ToolBarSeparator inserts separator into ToolBar.
ToolBox — ToolBox provides a column of tabbed widget items.
ToolButton — ToolButton provides a quick-access button, usually used inside a ToolBar.
Widget — Placeholder for other items

Chapter 1. GUI Item Table

Item NameDescriptionPropertiesChild Items
ButtonGroup ButtonGroup is a widget with a group of buttons.
ComboBox ComboBox is a combined button and popup list.

None

ContextMenu ContextMenu provides a context (popup) menu widget.
Dialog Creates modeless and modal dialogs.
Document Xml document instance interface
GridLayout GridLayout lines up child items in a table manner.
GridWidget GridWidget is a cell of GridLayout. Grid Widget is placed in its row and column of GridLayout accordingto the properties.
Label Label is a text label with an optional outline and arbitrary background color.

None

Layout Layout lines up child items horizontally or vertically.
LineEdit LineEdit is a one-line text editor.

None

ListView ListView provides a list/tree view.
ListViewItem ListViewItem provides item for ListView.

None

MainMenu MainMenu provides menu bar for MainWindow.
MainWindow MainWindow of Serna Application.

None
MenuButton MenuButton provides buttons (similar to ToolButton) suitable for MainMenu.

None

MenuItem MenuItem provides menu item for MainMenu, PopupMenu and ContextMenu.

None

MenuSeparator MenuSeparator inserts separator into menus. Is is suitable for PopupMenus andContextMenus.

None

PopupMenu PopupMenu provides a popup menu widget. PopupMenu can have PopupMenu as a child.
PushButton PushButton provides a command button, usually used in Dialog.

None

RadioButton RadioButton provides a radio button with a text or label.

None

Splitter Splitter provides splitter widget.
StatusBar StatusBar is a horizontal bar at the bottom of MainWindow suitable for presenting status information.
Stretch  

None

TabWidget Stack of tabbed items.
ToolBar ToolBar - dockable tool panel containing widgets such as tool buttons.
ToolBarSeparator ToolBarSeparator inserts separator into ToolBar.

None

ToolBox ToolBox provides a column of tabbed widget items.
ToolButton ToolButton provides a quick-access button, usually used inside a ToolBar.

None

Widget Placeholder for other items

Chapter 2. GUI Items Detailed Description

Table of Contents

ButtonGroup — ButtonGroup is a widget with a group of buttons.
ComboBox — ComboBox is a combined button and popup list.
ContextMenu — ContextMenu provides a context (popup) menu widget.
Dialog — Creates modeless and modal dialogs.
Document — Xml document instance interface
GridLayout — GridLayout lines up child items in a table manner.
GridWidget — GridWidget is a cell of GridLayout. Grid Widget is placed in its row and column of GridLayout according to the properties.
Label — Label is a text label with an optional outline and arbitrary background color.
Layout — Layout lines up child items horizontally or vertically.
LineEdit — LineEdit is a one-line text editor.
ListView — ListView provides a list/tree view.
ListViewItem — ListViewItem provides item for ListView.
MainMenu — MainMenu provides menu bar for MainWindow.
MainWindow — MainWindow of Serna Application.
MenuButton — MenuButton provides buttons (similar to ToolButton) suitable for MainMenu.
MenuItem — MenuItem provides menu item for MainMenu, PopupMenu and ContextMenu.
MenuSeparator — MenuSeparator inserts separator into menus. Is is suitable for PopupMenus andContextMenus.
PopupMenu — PopupMenu provides a popup menu widget. PopupMenu can have PopupMenu as a child.
PushButton — PushButton provides a command button, usually used in Dialog.
RadioButton — RadioButton provides a radio button with a text or label.
Splitter — Splitter provides splitter widget.
StatusBar — StatusBar is a horizontal bar at the bottom of MainWindow suitable for presenting status information.
Stretch —
TabWidget — Stack of tabbed items.
ToolBar — ToolBar - dockable tool panel containing widgets such as tool buttons.
ToolBarSeparator — ToolBarSeparator inserts separator into ToolBar.
ToolBox — ToolBox provides a column of tabbed widget items.
ToolButton — ToolButton provides a quick-access button, usually used inside a ToolBar.
Widget — Placeholder for other items

Name

ButtonGroup — ButtonGroup is a widget with a group of buttons.

Description

ButtonGroup is a grouping widget (that may contain buttons) with an optional title.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • title. Title shown at the top of button group.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

ComboBox — ComboBox is a combined button and popup list.

Description

Properties

  • accel. keyboard accelerator (shortcut keys).

  • action. Binds ui item and an action it calls.

    • action.  Name of child action or property aggregation for child action.

      • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

      • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

      • is-enabled.  Specifies whether ui item is enabled.

      • name.  Specifies name for UiItems and UiActions.

      • tooltip.  Specifies tooltip used in widgets.

    • current-action.  Specifies sequential number of current child action.

    • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

    • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

    • is-enabled.  Specifies whether ui item is enabled.

    • name.  Specifies name for UiItems and UiActions.

    • tooltip.  Specifies tooltip used in widgets.

  • insertion-policy. Specifies insertion policy for editable combo box. "no-insertion" is default value, otherwise new input value is appended to the list.

  • is-editable. Specifies if the combo box is editable or not.

  • is-toggleable. Controls whether ui control (MenuItem, PushButton, ToolButton) can be toggled on/off.

  • is-toggled. Is ui control currently toggled on. This property takes effect only if "is-toggled" is "true"

Included Items

None

Name

ContextMenu — ContextMenu provides a context (popup) menu widget.

Description

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

Dialog — Creates modeless and modal dialogs.

Description

Dialog is used to cover simple use-cases for interaction with users.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • caption. Caption of the dialog.

  • height. Height of the Dialog in pixels.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-modal. is-modal is "true" for modal Dialog

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

  • width. Width of the Dialog in pixels.

Included Items

Name

Document — Xml document instance interface

Description

Document keeps all items representing user interface of the specific document instance. Number and types of children may depend on certain document type.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

GridLayout — GridLayout lines up child items in a table manner.

Description

GridLayout divides given space into rows and columns, and puts each child (GridWidget) into the certain cell.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • col-num. Number of columns in a grid.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • margin. Specifies (outer) space around all items.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • row-num. Number of rows in a grid.

  • spacing. Specifies space between items in Layout.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

GridWidget — GridWidget is a cell of GridLayout. Grid Widget is placed in its row and column of GridLayout according to the properties.

Description

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • col. Specifies grid column in which this item will be placed.

  • col-span. Specifies how many columns will this item occupy.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • row. Specifies grid row in which this item will be placed.

  • row-span. Specifies how many rows will this item occupy.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

Label — Label is a text label with an optional outline and arbitrary background color.

Description

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • color. Specifies the background color for Label.

  • height. Specifies height of the Label.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • size-policy. Specifies resizing of Label. By default the value is "ignored",which defines the fixed geometry. Otherwise the size is determined by text size.

  • tooltip. Text of tooltip that will be shown for UI item widget.

  • width. Specifies width of the Label.

Included Items

None

Name

Layout — Layout lines up child items horizontally or vertically.

Description

Layout divides the space it gets (from its parent item) into a row of boxes, and places each child item in its cell.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • margin. Specifies (outer) space around all items.

  • name. Ui item name. Name is unique among descendants of Document.

  • orientation. Orientation od Layout.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • spacing. Specifies space between items in Layout.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

LineEdit — LineEdit is a one-line text editor.

Description

LineEdit is a simple one-line text editor. It is used mainly in Dialog items.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • editable. TODO: use "is-enabled" property.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • text. Current text in line edit.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

None

Name

ListView — ListView provides a list/tree view.

Description

ListView can display a hierarchy of multi-column items. User may select one or many items (depending on the SelectionMode) and sort the list in increasing or decreasing order by any column.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • col-specs. ListView header specifications

    • column. Column specifications for list view header

      • icon. Icon in column header.

      • text. Text in column header.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

ListViewItem — ListViewItem provides item for ListView.

Description

ListViewItem provides item for ListView. It can display data (icon and/or text) in multiple columns.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • data. Groups the text specifications for all columns.

    • column. Column item data.

      • icon. Item icon for given column.

      • text. Item text for given column.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

None

Name

MainMenu — MainMenu provides menu bar for MainWindow.

Description

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

MainWindow — MainWindow of Serna Application.

Description

There are different meanings of MainWindow from the *.SUI and *.SPD points of view.

From *.SUI point MainWindow represents main window of Serna Application. There are several MainWindow items allowed at a time. Each MainWindow can have several Document items which represent a specific document instances.

From *.SPD point MainWindow is a Document. This is because plugin is loaded for current Document instance and other Documents are irrelevant for the UI instantiation. MainWindow and its children represent a view (UI) for specific document and its type.

Properties

None

Included Items

Name

MenuButton — MenuButton provides buttons (similar to ToolButton) suitable for MainMenu.

Description

Properties

  • accel. keyboard accelerator (shortcut keys).

  • action. Binds ui item and an action it calls.

    • action.  Name of child action or property aggregation for child action.

      • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

      • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

      • is-enabled.  Specifies whether ui item is enabled.

      • name.  Specifies name for UiItems and UiActions.

      • tooltip.  Specifies tooltip used in widgets.

    • current-action.  Specifies sequential number of current child action.

    • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

    • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

    • is-enabled.  Specifies whether ui item is enabled.

    • name.  Specifies name for UiItems and UiActions.

    • tooltip.  Specifies tooltip used in widgets.

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-toggleable. Controls whether ui control (MenuItem, PushButton, ToolButton) can be toggled on/off.

  • is-toggled. Is ui control currently toggled on. This property takes effect only if "is-toggled" is "true"

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

None

Name

MenuItem — MenuItem provides menu item for MainMenu, PopupMenu and ContextMenu.

Description

Properties

  • accel. keyboard accelerator (shortcut keys).

  • action. Binds ui item and an action it calls.

    • action.  Name of child action or property aggregation for child action.

      • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

      • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

      • is-enabled.  Specifies whether ui item is enabled.

      • name.  Specifies name for UiItems and UiActions.

      • tooltip.  Specifies tooltip used in widgets.

    • current-action.  Specifies sequential number of current child action.

    • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

    • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

    • is-enabled.  Specifies whether ui item is enabled.

    • name.  Specifies name for UiItems and UiActions.

    • tooltip.  Specifies tooltip used in widgets.

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-toggleable. Controls whether ui control (MenuItem, PushButton, ToolButton) can be toggled on/off.

  • is-toggled. Is ui control currently toggled on. This property takes effect only if "is-toggled" is "true"

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

None

Name

MenuSeparator — MenuSeparator inserts separator into menus. Is is suitable for PopupMenus andContextMenus.

Description

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

None

Name

PopupMenu — PopupMenu provides a popup menu widget. PopupMenu can have PopupMenu as a child.

Description

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

PushButton — PushButton provides a command button, usually used in Dialog.

Description

Properties

  • accel. keyboard accelerator (shortcut keys).

  • action. Binds ui item and an action it calls.

    • action.  Name of child action or property aggregation for child action.

      • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

      • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

      • is-enabled.  Specifies whether ui item is enabled.

      • name.  Specifies name for UiItems and UiActions.

      • tooltip.  Specifies tooltip used in widgets.

    • current-action.  Specifies sequential number of current child action.

    • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

    • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

    • is-enabled.  Specifies whether ui item is enabled.

    • name.  Specifies name for UiItems and UiActions.

    • tooltip.  Specifies tooltip used in widgets.

  • is-toggleable. Controls whether ui control (MenuItem, PushButton, ToolButton) can be toggled on/off.

  • is-toggled. Is ui control currently toggled on. This property takes effect only if "is-toggled" is "true"

  • use-accel. Specifies if ToolButton uses keyboard accelerator or not.

Included Items

None

Name

RadioButton — RadioButton provides a radio button with a text or label.

Description

RadioButtons should be a children of GroupBox to provide a "one of many" choice functionality.

Properties

  • accel. keyboard accelerator (shortcut keys).

  • action. Binds ui item and an action it calls.

    • action.  Name of child action or property aggregation for child action.

      • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

      • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

      • is-enabled.  Specifies whether ui item is enabled.

      • name.  Specifies name for UiItems and UiActions.

      • tooltip.  Specifies tooltip used in widgets.

    • current-action.  Specifies sequential number of current child action.

    • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

    • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

    • is-enabled.  Specifies whether ui item is enabled.

    • name.  Specifies name for UiItems and UiActions.

    • tooltip.  Specifies tooltip used in widgets.

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-toggleable. Controls whether ui control (MenuItem, PushButton, ToolButton) can be toggled on/off.

  • is-toggled. Is ui control currently toggled on. This property takes effect only if "is-toggled" is "true"

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

None

Name

Splitter — Splitter provides splitter widget.

Description

Splitter lays out its children horizontally or vertically, depending on "orientation" property.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • orientation. Specifies orientation of laid out items.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • proportions. Space delimited integers specify the geometric proportions for child items.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

StatusBar — StatusBar is a horizontal bar at the bottom of MainWindow suitable for presenting status information.

Description

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

Stretch —

Description

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

None

Name

TabWidget — Stack of tabbed items.

Description

TabWidget organizes its children as a stack with one child visible at a time. Current (visible) item can be chosen via tab bar at a top (or bottom - depending on properties) of TabWidget.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

ToolBar — ToolBar - dockable tool panel containing widgets such as tool buttons.

Description

ToolBar keeps ToolButtons and other relatively simple UI controls: labels, combo-boxes, line-edits etc.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • caption. Caption for the ToolBar is shown when it is undocked.

  • dock-edge. Specifies the docking position of the ToolBar.

  • horizontally-stretchable. Specifies if the ToolBar is horizontally stretchable .

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • resize-enabled. Specifies whether the ToolBar can be resized or is fixed-size.

  • tooltip. Text of tooltip that will be shown for UI item widget.

  • vertically-stretchable. Specifies if the ToolBar is vertically stretchable .

Included Items

Name

ToolBarSeparator — ToolBarSeparator inserts separator into ToolBar.

Description

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

None

Name

ToolBox — ToolBox provides a column of tabbed widget items.

Description

ToolBox provides a widget that displays a column of tabs one above the other, with the current item displayed below the current tab.

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

Name

ToolButton — ToolButton provides a quick-access button, usually used inside a ToolBar.

Description

Properties

  • accel. keyboard accelerator (shortcut keys).

  • action. Binds ui item and an action it calls.

    • action.  Name of child action or property aggregation for child action.

      • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

      • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

      • is-enabled.  Specifies whether ui item is enabled.

      • name.  Specifies name for UiItems and UiActions.

      • tooltip.  Specifies tooltip used in widgets.

    • current-action.  Specifies sequential number of current child action.

    • icon.  Specifies icon shown in MenuItem, ToolButton, PushButton, etc.

    • inscription.  Specifies text displayed for MenuItem, Label, TabWidget etc.

    • is-enabled.  Specifies whether ui item is enabled.

    • name.  Specifies name for UiItems and UiActions.

    • tooltip.  Specifies tooltip used in widgets.

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-toggleable. Controls whether ui control (MenuItem, PushButton, ToolButton) can be toggled on/off.

  • is-toggled. Is ui control currently toggled on. This property takes effect only if "is-toggled" is "true"

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items

None

Name

Widget — Placeholder for other items

Description

Properties

  • after.  Specifies after which uiItem this uiItem should be placed.

  • before.  Specifies before which uiItem this uiItem should be placed.

  • icon. Icon shown in widget or menu item.

  • inscription. Text shown in widget or menu item.

  • is-enabled. Controls whether widget provided by UI item is enabled or disabled (grayed out)

  • is-visible. Controls whether the items is visible or not.

  • name. Ui item name. Name is unique among descendants of Document.

  • parent.  Specifies inside which uiItem this uiItem should be placed.

  • tooltip. Text of tooltip that will be shown for UI item widget.

Included Items