Widgets
QuickUI defines a set of widgets. The ones currently available are:
All widgets have two attributes that are required: id and
text. The id attribute is a unique identifier,
while the text attribute contains a description of the
widget. Here is a screenshot of a GUI
createad out of all the examples below.
file
| Name | Required | Default | Value | Description |
|---|---|---|---|---|
| mode | yes | - | open|save |
Open or save file dialog. |
| button | no | "Browse..." |
.* |
The text of the browse button. |
| filter | no | "" | [a-z]+(\|[a-z]+)* |
A pipe (|) separated list of file extensions to show in the file dialog. |
| value | no | "" | .* |
Default value for the widget. |
| dir | no | "" | .* |
Start directory for the file dialog if default attribute is not specified. |
Example:
<file id="doc" text="Input document" mode="open" button="Browse..."/>
checkbox
| Name | Required | Default | Value | Description |
|---|---|---|---|---|
| value | no | "off" | on|off |
Descides whether the checkbox should be checked at startup or not. |
Example:
<checkbox id="doTask" text="Perform task" value="on"/>
radio
Each radio widget consists of a radio element containing one
or more item elements. Each item element
describes one radio item. The value of the radio widget is the
id of the currently selected item.
Apart from the id and text attributes, the
item element can have the following attribute:
| Name | Required | Default | Value | Description |
|---|---|---|---|---|
| value | no | "off" | on|off |
Descides whether the item should be selected at startup or not. |
Example:
<radio id="fruit" text="Favorite fruit">
<item id="apples" text="Apples"/>
<item id="oranges" text="Oranges" value="on"/>
</radio>
text
| Name | Required | Default | Value | Description |
|---|---|---|---|---|
| value | no | "" | .* |
The default value of the widget. |
Example:
<text id="field" text="Name" value="Mr. Smith"/>
textarea
| Name | Required | Default | Value | Description |
|---|---|---|---|---|
| rows | no | "5" | 1-100 |
The initial number of rows the textarea should occupy. |
Example:
<textarea id="area" text="Description" rows="10"/>
spinbox
| Name | Required | Default | Value | Description |
|---|---|---|---|---|
| value | no | "0" | integer | The initial value of the spinbox. |
| min | no | "0" | integer | The minimum value of the spinbox. |
| max | no | "100" | integer | The maximum value of the spinbox. |
Example:
<spinbox id="box" text="Number of pins" min="0" max="50" value="22"/>
button
Example:
<button id="okButton" text="OK"/>