Overview generic classes

Each generic class has dedicated properties, which will be described within this chapter.

These classes describe components, which can be used to enter values or to show simple text or images:

ClassDescription
ComboBoxConsists of a textfield and a list of selectable options. See subsection 57.2.8.
GraphicsShows a graphics or a diagram. Clicks could raise an action, but that's not mandatory. See subsection 57.2.12.
IconShows an image. Clicks could raise an action, but that's not mandatory. See subsection 57.2.13.
LabelShows some text, like a caption. Clicks could raise an action, but that's not necessary. See subsection 57.2.16.
ProgressBarShows the current progress of an action. See subsection 57.2.28.
SliderAllows the user to select a value via a thumb. See subsection 57.2.32.
SpinnerAllows the user to select a value via arrow-buttons combined with a textfield. See subsection 57.2.34.
TextShows common text with multiple rows. A user can't enter any value. See subsection 57.2.43.
TextAreaAllows the user to enter text, even with multiple lines. It is able to show that text as well. See subsection 57.2.44.
TextFieldAllows the user to enter single-line text. It is able to show that text as well. See subsection 57.2.45.
Table 57.1:  Generic classes for input and output

Those generic classes are normally used for direct interaction with the user like clicks. Those components could have a state:

ClassDescription
ButtonRaises an action, once it is clicked. It normally doesn't have a defined state. See subsection 57.2.3.
CheckBoxHas a dedicated state. Usually you can check and un-check those components. See subsection 57.2.6.
CloserCloses a component, e.g. the 'X' button of a window. See subsection 57.2.7.
LinkAllows the user to navigate to another area of the application. See subsection 57.2.17.
MaximizerMaximizes the size of a component, e.g. of a window. See subsection 57.2.20.
MenuItemIs shown in menus. A click normally raises an action or changes the application's state. See subsection 57.2.22.
MinimizerMinimizes the size of a component, e.g. of a window. See subsection 57.2.23.
RadioButtonStands for a selectable option. It is typically used for selecting a state, if various states are allowed. See subsection 57.2.25.
RestoreRe-creates the original size of a component, e.g. of a window. See subsection 57.2.26.
SizerModifies the size of a component, e.g. of a window. See subsection 57.2.31.
ThumbCan be used to thumb through certain values on a slider component. See subsection 57.2.46.
ToggleButtonCan be clicked like a button and has a certain state as well. Sometimes clicks also raise actions. See subsection 57.2.47.
ToolBarItemStands for a clickable component inside a toolbar. See subsection 57.2.49.
Table 57.2:  Generic classes for interactions

Those components can be applied as containers, to organize other components:

ClassDescription
AccordionCan be used as navigator between components. Components can be expanded and collapsed. See subsection 57.2.1.
CalendarCan be used to select a date or time. See subsection 57.2.4.
ColorPickerCan be used to select a certain color. See subsection 57.2.5.
FileChooserCan be used to select a file. Usually it consists of a textfield, a list of files and a button to choose. See subsection 57.2.11.
IndicatorShows a message after an input event. Typically they appear after entering something into textfields, could also contain an icon. See subsection 57.2.14.
MenuContains multiple menu items. See subsection 57.2.21.
PopupShows components, which are only shown after a click on certain buttons and which belong to that button, e.g. the list after clicking on a button of a combobox. See subsection 57.2.24.
PanelContains various components. Can be used to organize the UI. See subsection 57.2.27.
SplitPanelShows components. Those components are located in resizable areas. See subsection 57.2.35.
TabPanelCan be used to navigate between components. Those components are shown in dedicated cards ("tabs"). Only one tab can be visible at once. See subsection 57.2.41.
ToolBarStands for a toolbar. It typically contains several menu-items and important buttons to raise most common actions. See subsection 57.2.48.
ToolTipA window, which gets opened as some kind of hint. Normally shown, if the user moves the mouse over a component. See subsection 57.2.50.
WindowStands for a usual window. See subsection 57.2.54.
Table 57.3:  Generic classes for container components

Besides classes for container components, there are also classes which allows the user to show content in a well-organized structure:

ClassDescription
ListShows multiple values. Values could be selectable as well. See subsection 57.2.18.
TableShows multiple values. It has several dimensions columns. Values could be selectable as well. See subsection 57.2.36.
TableFooterFooter row of a table. See subsection 57.2.38.
TableHeaderHeader row of a table. See subsection 57.2.39.
TreeShows content as tree. Can be used to show values in certain categories. See subsection 57.2.51.
TreeTableShows content as tree. Can be used to show values in certain categories. Values normally consist of several columns like in a table. See subsection 57.2.53.
Table 57.4:  Generic classes for data containers

Data itself is implemented with following classes:

ClassDescription
ItemSub-item of a list, can be selectable. See subsection 57.2.15.
TableCellA value of a table. It is identified by its column and its position in the row. See subsection 57.2.37.
TableHeaderCellName of a column. See subsection 57.2.40.
TableRowRow of a table. See subsection 57.2.42.
TreeNodeSub-item of a tree. See subsection 57.2.52.
Table 57.5:  Generic classes for data

Beside classes for input, interaction, data or structuring a couple of classes exist, which only appear in very certain contexts:

ClassDescription
BusyPaneIs drawn over other components to lock them. See subsection 57.2.2.
DividerSplits areas of certain components. It can be moved. See subsection 57.2.9.
ExpanderIs used to expand or collapse a component, e.g. for a node of a tree. See subsection 57.2.10.
LoadingComponentIs used to show that your application is busy, e.g. if something is getting loaded by your application. See subsection 57.2.19.
ScrollBarIs used for scrolling a component. Usually it contains a something like a thumb. See subsection 57.2.29.
SeparatorSplits areas of certain components. It cannot be moved. See subsection 57.2.30.
SpacerActs as some kind of indentation, e.g. for nodes of a tree. See subsection 57.2.33.
Table 57.6:  Generic classes for specific components