gwenhywfar
5.11.1beta
|
Platform and toolkit independent XML-based dialog framework. More...
Modules | |
Implementation Notes | |
Implementation hints. | |
Dialogs | |
This module contains the definition of GWEN_GUI dialogs. | |
Platform and toolkit independent XML-based dialog framework.
A dialog consists of a tree of widgets.
Widgets can have integer and string properties. Some widgets also emit signals (like a push button which emits the "Activated" signal when clicked). See GWEN_Dialog_SetIntProperty, GWEN_Dialog_GetIntProperty, GWEN_Dialog_SetCharProperty and GWEN_Dialog_GetCharProperty about how to get or manipulate widget properties.
There is a special signal GWEN_DialogEvent_TypeInit which is emitted immediately before a dialog is shown to the user (e.g. upon GWEN_Gui_ExecDialog). It is only after the reception of this signal that properties become available for the property retrieval and manipulation functions mentioned above.
Some widgets may allow for HTML text, e.g. the FOX and QT3/4 implementations allow for HTML text as title property. However, not all implementations might have HTML support, so it must still be possible to set standard text which is then used by HTML-agnostic implementations. The chosen way to do this in the GWEN_Dialog framework is to specify both formats in a single string. String properties with the "html" mark in the following list may contain text in the following format:
As you can see HTML text is enclosed by the HTML element "html". Everything outside that is supposed to be standard text.
Implementations which are aware of HTML text will only use that enclosed part and ignore the rest. HTML-agnostic implementations will use the text outside those "html" markings.
The following properties are handled by all widgets.
This is a simple label widget (e.g. QLabel in QT or FXLabel in FOX).
The following properties are handled by this widget.
This widget does not emit special signals.
This is a simple push button widget (e.g. QPushButton in QT or FXButton in FOX).
This widget does not have special integer properties.
The following properties are handled by this widget.
This is a one line edit field widget (e.g. QLineEdit in QT or FXTextField in FOX).
This widget does not have special integer properties.
The following properties are handled by this widget.
This is a multi line edit field widget (e.g. Q?? in QT or FXText in FOX).
This widget does not have special integer properties.
The following properties are handled by this widget.
No special signals for now.
This is a combobox widget (e.g. QComboBox in QT or FXComboBox in FOX).
The following properties are handled by this widget.
The following properties are handled by this widget.
This widget is a simple progress bar. It has a total value which represents 100 percent and a progress value (from which the percentage is calculated and shown).
The following properties are handled by this widget.
No special signals.
This widget is a box surrounding other widgets with a thin line. It may also have a title.
The following properties are handled by this widget.
This widget does not emit special signals.
A list box is a simple list with a horizontal title header at the top. Entries of a list may have multiple columns.
The following properties are handled by this widget.
index
(see GWEN_Dialog_SetIntProperty). When setting this property index
is the column whose width is to be changed and value
is the new width. index
(see GWEN_Dialog_SetIntProperty). index
(see GWEN_Dialog_SetIntProperty). Only one column can determine the sort direction at any given time, so setting the direction of one column will remove the direction tag from every other column. If a column has a sorting direction other than GWEN_DialogSortDirection_None then that column will determine how the list will be sorted. The following properties are handled by this widget.
GWEN_Widget_TypeHSpacer GWEN_Widget_TypeVSpacer GWEN_Widget_TypeHLayout GWEN_Widget_TypeVLayout GWEN_Widget_TypeGridLayout GWEN_Widget_TypeDialog GWEN_Widget_TypeTabBook GWEN_Widget_TypeTabPage GWEN_Widget_TypeCheckBox GWEN_Widget_TypeWidgetStack GWEN_Widget_TypeScrollArea GWEN_Widget_TypeHLine GWEN_Widget_TypeVLine GWEN_Widget_TypeRadioButton