widgets.xml

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="widgets.xsl"?>
<elements>
    <element>
        <name>ui</name>
        <description>Root element (related to Custom UI window).</description>
        <see-also>
            <element>stretch</element>
            <element>br</element>
        </see-also>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>modal</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, the dialog window will be modal.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>title</name>
                <type>string</type>
                <default>Custom UI</default>
                <description>Title of the Custom UI window.</description>
            </attribute>
            <attribute>
                <name>resizable</name>
                <type>bool</type>
                <default>false</default>
                <description>Make window resizable if true.</description>
            </attribute>
            <attribute>
                <name>closeable</name>
                <type>bool</type>
                <default>false</default>
                <description>Make window closeable if true.</description>
            </attribute>
            <attribute>
                <name>layout</name>
                <type><one-of><value>vbox</value><value>hbox</value><value>form</value><value>grid</value><value>none</value></one-of></type>
                <default>vbox</default>
                <description>Layout of the widget. When layout is 'none', specify widget placement using the geometry attribute, like: geometry="x,y,width,height".</description>
            </attribute>
            <attribute>
                <name>placement</name>
                <type><one-of><value>center</value><value>relative</value><value>absolute</value></one-of></type>
                <default>center</default>
                <description>Placement of the window widget. It will affect how the position attribute is interpreted.</description>
            </attribute>
            <attribute>
                <name>position</name>
                <type>int[2]</type>
                <default>50,50</default>
                <description>Position of the window widget.</description>
            </attribute>
            <attribute>
                <name>size</name>
                <type>int[2]</type>
                <default>-1,-1</default>
                <description>Initial size of the window widget. -1,-1 will use the default behavior (automatically compute the optimal size).</description>
            </attribute>
            <attribute>
                <name>activate</name>
                <type>bool</type>
                <default>true</default>
                <description>If false, the window is shown without activating it (Qt flag WA_ShowWithoutActivating).</description>
            </attribute>
            <attribute>
                <name>on-close</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the close event. Arguments of the function are: (uiHandle). When a callback is specified, the window will not close upon pressing the close button. It may be hidden or destroyed explicitly in the callback.</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>button</name>
        <description>Push button widget.</description>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>text</name>
                <type>string</type>
                <default>???</default>
                <description>Text on the button.</description>
            </attribute>
            <attribute>
                <name>default</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, this is the default button of the dialog window.</description>
            </attribute>
            <attribute>
                <name>auto-repeat</name>
                <type>bool</type>
                <default>false</default>
                <description>If auto-repeat is enabled, then the click() signal is emitted at regular intervals when the button is down.</description>
            </attribute>
            <attribute>
                <name>auto-repeat-delay</name>
                <type>int</type>
                <default>0</default>
                <description>Defines the initial delay in milliseconds before auto-repetition kicks in.</description>
            </attribute>
            <attribute>
                <name>auto-repeat-interval</name>
                <type>int</type>
                <default>200</default>
                <description>Defines the length of the auto-repetition interval in milliseconds.</description>
            </attribute>
            <attribute>
                <name>checkable</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, the button is checkable.</description>
            </attribute>
            <attribute>
                <name>checked</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, the button is initially checked.</description>
            </attribute>
            <attribute>
                <name>auto-exclusive</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, checkable buttons that belong to the same parent widget behave as if they were part of the same exclusive button group. In an exclusive button group, only one button can be checked at any time; checking another button automatically unchecks the previously checked one.</description>
            </attribute>
            <attribute>
                <name>on-click</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the click event. Arguments of the function are: (uiHandle, id).</description>
            </attribute>
            <attribute>
                <name>icon</name>
                <type>string</type>
                <default />
                <description>Name of a icon to use. The only icon name scheme supported is default://SP_xxx where SP_xxx is a constant from http://doc.qt.io/qt-5/qstyle.html#StandardPixmap-enum</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>checkbox</name>
        <description>Checkbox widget.</description>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>text</name>
                <type>string</type>
                <default>???</default>
                <description>Text on the checkbox label.</description>
            </attribute>
            <attribute>
                <name>checked</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, the checkbox is initially checked.</description>
            </attribute>
            <attribute>
                <name>checkable</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, the button is checkable.</description>
            </attribute>
            <attribute>
                <name>auto-exclusive</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, checkable buttons that belong to the same parent widget behave as if they were part of the same exclusive button group. In an exclusive button group, only one button can be checked at any time; checking another button automatically unchecks the previously checked one.</description>
            </attribute>
            <attribute>
                <name>on-change</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the change event.  Arguments of the function are: (uiHandle, id, newValue).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>combobox</name>
        <description>A combobox widget. It allows to select one from many items from a dropdown menu.  Items can be added as child XML nodes, e.g. &lt;item&gt;Item text&lt;/item&gt;, or dynamically via the Lua API.</description>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>checkable</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, the button is checkable.</description>
            </attribute>
            <attribute>
                <name>auto-exclusive</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, checkable buttons that belong to the same parent widget behave as if they were part of the same exclusive button group. In an exclusive button group, only one button can be checked at any time; checking another button automatically unchecks the previously checked one.</description>
            </attribute>
            <attribute>
                <name>on-change</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the change event.  Arguments of the function are: (uiHandle, id, newValue).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>edit</name>
        <description>A widget for text input.</description>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>value</name>
                <type>string</type>
                <default>???</default>
                <description>Initial text.</description>
            </attribute>
            <attribute>
                <name>password</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, display platform-dependent password mask characters instead of the characters actually entered.</description>
            </attribute>
            <attribute>
                <name>on-change</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the change event.  Arguments of the function are: (uiHandle, id, newValue).</description>
            </attribute>
            <attribute>
                <name>on-editing-finished</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the editing finished event.  Arguments of the function are: (uiHandle, id, newValue).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>group</name>
        <description>A widget for grouping other widgets.  Other widgets are specified as children of the &lt;group&gt; node.  It has its own layout, so it can be used to use a different layout only for a group of widgets. It is also required to group a set of radiobutton widgets.</description>
        <see-also>
            <element>stretch</element>
            <element>br</element>
        </see-also>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>flat</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, the group will have no visual appearance (text will be ignored).  Otherwise, it will have some visual appearance, depending on the platform.</description>
            </attribute>
            <attribute>
                <name>layout</name>
                <type><one-of><value>vbox</value><value>hbox</value><value>form</value><value>grid</value><value>none</value></one-of></type>
                <default>vbox</default>
                <description>Layout of the widget. When layout is 'none', specify widget placement using the geometry attribute, like: geometry="x,y,width,height".</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>hslider</name>
        <description>A horizontal slider widget.</description>
        <see-also>
            <element>vslider</element>
        </see-also>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>minimum</name>
                <type>int</type>
                <default>0</default>
                <description>Minimum value.</description>
            </attribute>
            <attribute>
                <name>maximum</name>
                <type>int</type>
                <default>100</default>
                <description>Maximum value.</description>
            </attribute>
            <attribute>
                <name>tick-interval</name>
                <type>int</type>
                <default>0</default>
                <description>Tick interval.</description>
            </attribute>
            <attribute>
                <name>tick-position</name>
                <type><one-of><value>none</value><value>both-sides</value><value>above</value><value>below</value><value>left</value><value>right</value></one-of></type>
                <default>none</default>
                <description>In which direction to draw ticks.</description>
            </attribute>
            <attribute>
                <name>inverted</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, minimum and maximum will be swapped.</description>
            </attribute>
            <attribute>
                <name>on-change</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the change event.  Arguments of the function are: (uiHandle, id, newValue).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>image</name>
        <description>A image display widget.</description>
        <see-also>
            <element>label</element>
        </see-also>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>file</name>
                <type>string</type>
                <default></default>
                <description>Display the image from the specified file.</description>
            </attribute>
            <attribute>
                <name>width</name>
                <type>int</type>
                <default>-1</default>
                <description>Desired width for the initial image.</description>
            </attribute>
            <attribute>
                <name>height</name>
                <type>int</type>
                <default>-1</default>
                <description>Desired height for the initial image.</description>
            </attribute>
            <attribute>
                <name>on-mouse-down</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the mouseDown event. Arguments of the function are: (uiHandle, id, type, flags, x, y).</description>
            </attribute>
            <attribute>
                <name>on-mouse-up</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the mouseUp event. Arguments of the function are: (uiHandle, id, type, flags, x, y).</description>
            </attribute>
            <attribute>
                <name>on-mouse-move</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the mouseMove event. Arguments of the function are: (uiHandle, id, type, flags, x, y).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>label</name>
        <description>A static text widget.</description>
        <see-also>
            <element>edit</element>
        </see-also>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>text</name>
                <type>string</type>
                <default>???</default>
                <description>Text on the label.</description>
            </attribute>
            <attribute>
                <name>wordwrap</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, long text will wrap in multiple lines, otherwise will be cut.</description>
            </attribute>
            <attribute>
                <name>on-link-activated</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the linkActivated event. Arguments of the function are: (uiHandle, id, linkHref).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>plot</name>
        <description>A widget for displaying time series charts.</description>
        <attributes>
            <attribute>
                <name>background-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the background, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the color of the window's background.</description>
            </attribute>
            <attribute>
                <name>foreground-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the foreground elements (i.e.: axes, axes labels, tick labels, tick marks and grid lines), as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color. This value can be overridden by any of the specific attributes for the individual elements.</description>
            </attribute>
            <attribute>
                <name>axis-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the axes, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color. Can be overridden by axis-x-color and axis-y-color.</description>
            </attribute>
            <attribute>
                <name>label-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the axis labels, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color. Can be overridden by label-x-color and label-y-color.</description>
            </attribute>
            <attribute>
                <name>grid-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the grid, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color. Can be overridden by grid-x-color and grid-y-color.</description>
            </attribute>
            <attribute>
                <name>tick-label-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the tick labels, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color.</description>
            </attribute>
            <attribute>
                <name>axis-x-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the X axis, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color.</description>
            </attribute>
            <attribute>
                <name>axis-y-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the Y axis, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color.</description>
            </attribute>
            <attribute>
                <name>label-x-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the X label, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color.</description>
            </attribute>
            <attribute>
                <name>label-y-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the Y label, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color.</description>
            </attribute>
            <attribute>
                <name>grid-x-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the X grid, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color.</description>
            </attribute>
            <attribute>
                <name>grid-y-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the Y grid, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color.</description>
            </attribute>
            <attribute>
                <name>tick-label-x-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the X tick labels, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color.</description>
            </attribute>
            <attribute>
                <name>tick-label-y-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the Y tick labels, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the default color.</description>
            </attribute>
            <attribute>
                <name>square</name>
                <type>bool</type>
                <default>false</default>
                <description></description>
            </attribute>
            <attribute>
                <name>max-buffer-size</name>
                <type>int</type>
                <default>1000</default>
                <description>Maximum size of the buffer(s).</description>
            </attribute>
            <attribute>
                <name>cyclic-buffer</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, buffers will be cyclic when full.</description>
            </attribute>
            <attribute>
                <name>ticks</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, x and y tickmarks will be visible.</description>
            </attribute>
            <attribute>
                <name>x-ticks</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, x tickmarks will be visible.</description>
            </attribute>
            <attribute>
                <name>y-ticks</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, y tickmarks will be visible.</description>
            </attribute>
            <attribute>
                <name>tick-labels</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, x and y tick labels will be visible.</description>
            </attribute>
            <attribute>
                <name>x-tick-labels</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, x tick labels will be visible.</description>
            </attribute>
            <attribute>
                <name>y-tick-labels</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, y tick labels will be visible.</description>
            </attribute>
            <attribute>
                <name>on-click</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the click event on a curve data point.  Arguments of the function are: (uiHandle, id, curveName, dataIndex, xValue, yValue).</description>
            </attribute>
            <attribute>
                <name>on-legend-click</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the click event on a legend item.  Arguments of the function are: (uiHandle, id, curveName).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>progressbar</name>
        <description>A progress indicator widget.</description>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>minimum</name>
                <type>int</type>
                <default>0</default>
                <description>Minimum value of the progress.</description>
            </attribute>
            <attribute>
                <name>maximum</name>
                <type>int</type>
                <default>100</default>
                <description>Maximum value of the progress.</description>
            </attribute>
            <attribute>
                <name>orientation</name>
                <type><one-of><value>horizontal</value><value>vertical</value></one-of></type>
                <default>horizontal</default>
                <description>Orientation.</description>
            </attribute>
            <attribute>
                <name>inverted</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, the progress ends will be inverted.</description>
            </attribute>
            <attribute>
                <name>value</name>
                <type>int</type>
                <default>0</default>
                <description>Initial value.</description>
            </attribute>
            <attribute>
                <name>text-visible</name>
                <type>bool</type>
                <default>true</default>
                <description>Visibility of progress text.</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>radiobutton</name>
        <description>A radio button widget.</description>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>text</name>
                <type>string</type>
                <default>???</default>
                <description>Text on the button.</description>
            </attribute>
            <attribute>
                <name>checked</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, this button will be initially checked.</description>
            </attribute>
            <attribute>
                <name>on-click</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the click event.  Arguments of the function are: (uiHandle, id).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>scene3d</name>
        <description>A widget for displaying a 3D scene.</description>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>clear-color</name>
                <type>int[3]</type>
                <default>-1,-1,-1</default>
                <description>Color of the background, as three RGB components in the 0...255 range. The special value -1,-1,-1 means to use the color of the window's background.</description>
            </attribute>
            <attribute>
                <name>on-click</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the click event. Arguments of the function are: (uiHandle, id, nodeId).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>spinbox</name>
        <description>A widget for numeric input, with increase/decrease buttons.</description>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>minimum</name>
                <type>int or float</type>
                <default>0</default>
                <description>Minimum value.</description>
            </attribute>
            <attribute>
                <name>maximum</name>
                <type>int or float</type>
                <default>100</default>
                <description>Maximum value.</description>
            </attribute>
            <attribute>
                <name>prefix</name>
                <type>string</type>
                <default />
                <description>String prefix in the displayed value.</description>
            </attribute>
            <attribute>
                <name>suffix</name>
                <type>string</type>
                <default />
                <description>String suffix in the displayed value.</description>
            </attribute>
            <attribute>
                <name>step</name>
                <type>int or float</type>
                <default>1</default>
                <description>Step (increment/decrement) when using the buttons.</description>
            </attribute>
            <attribute>
                <name>float</name>
                <type>bool</type>
                <default>autodetect</default>
                <description>If true, the spinbox will display a floating point value. If false, the spinbox will display integer values. If omitted, this property will be automatically determined by minimum/maximum/step values: if any of those is not a round integer, the spinbox will be float.</description>
            </attribute>
            <attribute>
                <name>on-change</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the change event.  Arguments of the function are: (uiHandle, id, newValue).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>table</name>
        <description>A table widget. Can optionally contain a &lt;header&gt; elements and &lt;row&gt; elements. Each &lt;header&gt;/&lt;row&gt; element contains only &lt;item&gt; elements. &lt;item&gt; elements may have an optional "editable" attribute of type bool.</description>
        <attributes>
            <attribute>
                <name>show-horizontal-header</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, column headers will be visible.</description>
            </attribute>
            <attribute>
                <name>show-vertical-header</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, row headers will be visible. The 'label' attribute of the &lt;row&gt; can be used to change the displayed text of the row header. The default row header is the line number.</description>
            </attribute>
            <attribute>
                <name>autosize-horizontal-header</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, column headers will resize to fit contents.</description>
            </attribute>
            <attribute>
                <name>autosize-vertical-header</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, row headers will resize to fit contents.</description>
            </attribute>
            <attribute>
                <name>show-grid</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, grid will be visible.</description>
            </attribute>
            <attribute>
                <name>selection-mode</name>
                <type><one-of><value>items</value><value>rows</value><value>columns</value></one-of></type>
                <default>items</default>
                <description>Controls the selection behavior, i.e. if the user can select individual items, entire rows, or entire columns.</description>
            </attribute>
            <attribute>
                <name>editable</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, cells will be editable.</description>
            </attribute>
            <attribute>
                <name>sortable</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, it will be possible to sort data by columns by clicking on column headers.</description>
            </attribute>
            <attribute>
                <name>on-cell-activate</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the cell activate event. Arguments of the function are: (uiHandle, id, row, column, cellValue).</description>
            </attribute>
            <attribute>
                <name>on-selection-change</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the selection change event. Arguments of the function are: (uiHandle, id, row, column). If selection mode is 'rows', column will be -1 and vice versa.</description>
            </attribute>
            <attribute>
                <name>on-key-press</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the key press event. Arguments of the function are: (uiHandle, id, key, text).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>tabs</name>
        <description>A tabs widget. Must contain only &lt;tab&gt; child elements.</description>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
        </attributes>
        <see-also>
            <element>tab</element>
        </see-also>
    </element>
    <element>
        <name>tab</name>
        <description>A tab for the tabs widget. Can only be contained in a &lt;tabs&gt; element.
Can contain widgets, just like &lt;ui&gt; and &lt;group&gt;, and has its own layout.</description>
        <see-also>
            <element>stretch</element>
            <element>br</element>
        </see-also>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>title</name>
                <type>string</type>
                <default>???</default>
                <description>Title of the tab.</description>
            </attribute>
            <attribute>
                <name>layout</name>
                <type><one-of><value>vbox</value><value>hbox</value><value>form</value><value>grid</value><value>none</value></one-of></type>
                <default>vbox</default>
                <description>Layout of the widget. When layout is 'none', specify widget placement using the geometry attribute, like: geometry="x,y,width,height".</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>text-browser</name>
        <description>A text browser widget.</description>
        <see-also>
            <element>edit</element>
        </see-also>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>text</name>
                <type>string</type>
                <default></default>
                <description>Initial text content.</description>
            </attribute>
            <attribute>
                <name>html</name>
                <type>bool</type>
                <default>true</default>
                <description>if true, text will be treated as HTML</description>
            </attribute>
            <attribute>
                <name>read-only</name>
                <type>bool</type>
                <default>true</default>
                <description>if true, text will be read-only</description>
            </attribute>
            <attribute>
                <name>on-change</name>
                <type>string</type>
                <default></default>
                <description>Name of a Lua function to handle the change event.  Arguments of the function are: (uiHandle, id, newText).</description>
            </attribute>
            <attribute>
                <name>on-link-activated</name>
                <type>string</type>
                <default></default>
                <description>Name of a Lua function to handle the linkActivated event. Arguments of the function are: (uiHandle, id, linkHref).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>tree</name>
        <description>A tree widget. Must contain one &lt;header&gt; element and many &lt;row&gt; elements. Each &lt;header&gt;/&lt;row&gt; element contains only &lt;item&gt; elements. &lt;row&gt; elements can have 'id' and 'parent-id' attributes (positive integers) to set relationships between items, and a 'expanded' attribute (bool) to initially expand the item.</description>
        <attributes>
            <attribute>
                <name>show-header</name>
                <type>bool</type>
                <default>true</default>
                <description>If true, column headers will be visible.</description>
            </attribute>
            <attribute>
                <name>autosize-header</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, column headers will resize to fit contents.</description>
            </attribute>
            <attribute>
                <name>sortable</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, it will be possible to sort data by columns by clicking on column headers.</description>
            </attribute>
            <attribute>
                <name>on-selection-change</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the selection change event. Arguments of the function are: (uiHandle, id, item_id).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>vslider</name>
        <description>A vertical slider widget.</description>
        <see-also>
            <element>hslider</element>
        </see-also>
        <attributes>
            <attribute>
                <name>enabled</name>
                <type>bool</type>
                <default>true</default>
                <description>Enable status of widget.</description>
            </attribute>
            <attribute>
                <name>style</name>
                <type>string</type>
                <default />
                <description>Qt stylesheet.</description>
            </attribute>
            <attribute>
                <name>minimum</name>
                <type>int</type>
                <default>0</default>
                <description>Minimum value.</description>
            </attribute>
            <attribute>
                <name>maximum</name>
                <type>int</type>
                <default>100</default>
                <description>Maximum value.</description>
            </attribute>
            <attribute>
                <name>tick-interval</name>
                <type>int</type>
                <default>0</default>
                <description>Tick interval.</description>
            </attribute>
            <attribute>
                <name>tick-position</name>
                <type><one-of><value>none</value><value>both-sides</value><value>above</value><value>below</value><value>left</value><value>right</value></one-of></type>
                <default>none</default>
                <description>In which direction to draw ticks.</description>
            </attribute>
            <attribute>
                <name>inverted</name>
                <type>bool</type>
                <default>false</default>
                <description>If true, minimum and maximum will be swapped.</description>
            </attribute>
            <attribute>
                <name>on-change</name>
                <type>string</type>
                <default />
                <description>Name of a Lua function to handle the change event.  Arguments of the function are: (uiHandle, id, newValue).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>stretch</name>
        <description>Special element that can be put inside a parent with layout (such as &lt;ui&gt;, &lt;group&gt; or &lt;tab&gt;) if the layout is <b>hbox</b> or <b>vbox</b>.</description>
        <attributes>
            <attribute>
                <name>factor</name>
                <type>int</type>
                <default>0</default>
                <description>Stretch factor (see <a href="http://doc.qt.io/qt-4.8/layout.html#stretch-factors">http://doc.qt.io/qt-4.8/layout.html#stretch-factors</a>).</description>
            </attribute>
        </attributes>
    </element>
    <element>
        <name>br</name>
        <description>Special element that can be put inside a parent with layout (such as &lt;ui&gt;, &lt;group&gt; or &lt;tab&gt;) if the layout is <b>grid</b>, and it is used to begin a new line in the grid layout.</description>
        <attributes />
    </element>
</elements>