gwenhywfar  5.11.1beta
Modules
Toolkit Independent Dialog Framework

Platform and toolkit independent XML-based dialog framework. More...

Modules

 Implementation Notes
 Implementation hints.
 
 Dialogs
 This module contains the definition of GWEN_GUI dialogs.
 

Detailed Description

Platform and toolkit independent XML-based dialog framework.

GWEN_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.

String Properties

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:

"<html>this is the <b>html</b> version</html> and this is the standard text"

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.

All Widgets

Integer Properties

The following properties are handled by all widgets.

GWEN_Widget_TypeLabel

This is a simple label widget (e.g. QLabel in QT or FXLabel in FOX).

String Properties

The following properties are handled by this widget.

Signals

This widget does not emit special signals.

GWEN_Widget_TypePushButton

This is a simple push button widget (e.g. QPushButton in QT or FXButton in FOX).

Integer Properties

This widget does not have special integer properties.

String Properties

The following properties are handled by this widget.

GWEN_Widget_TypeLineEdit

This is a one line edit field widget (e.g. QLineEdit in QT or FXTextField in FOX).

Integer Properties

This widget does not have special integer properties.

String Properties

The following properties are handled by this widget.

Signals

GWEN_Widget_TypeTextEdit

This is a multi line edit field widget (e.g. Q?? in QT or FXText in FOX).

Integer Properties

This widget does not have special integer properties.

String Properties

The following properties are handled by this widget.

Signals

No special signals for now.

GWEN_Widget_TypeComboBox

This is a combobox widget (e.g. QComboBox in QT or FXComboBox in FOX).

Integer Properties

The following properties are handled by this widget.

String Properties

The following properties are handled by this widget.

Signals

GWEN_Widget_TypeProgressBar

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).

Integer Properties

The following properties are handled by this widget.

Signals

No special signals.

GWEN_Widget_TypeGroupBox

This widget is a box surrounding other widgets with a thin line. It may also have a title.

String Properties

The following properties are handled by this widget.

Signals

This widget does not emit special signals.

GWEN_Widget_TypeListBox

A list box is a simple list with a horizontal title header at the top. Entries of a list may have multiple columns.

Integer Properties

The following properties are handled by this widget.

String Properties

The following properties are handled by this widget.

Signals

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