Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | File List | Namespace Members | Class Members | File Members | Related Pages | Examples

XML format for the layout loader

Basic scheme of the document :

<?xml version="1.0"?>
<layout>

    <head>
    .
    .
    .
    </head>

    <body>
    .
    .
    .
    </body>
</layout>

Every tag has two form - long and short (if you use long form in the begining tag, you must use long form in the end tag a vice versa).

Main section tags

<layout>    <LA>

This tag is document base tag.
Must be first tag in the doc and it`s allowed to have exactly one this tag in the doc.
No parameters.

Layout section tags

<head>  <HD>

This tag defines head section.
Must be placed before

<BODY>
tag.
No parameters.

Note:
In the head section is not defined any tag yet.
<body>  <BD>

This tag defines body section.
In this section are defined every objects (widgets) you want to use and/or show.
No parameters.

Body section tags

Private params are only for this tag, public params are for use in the child`s tag.
param must be used.

<widget>    <WD>

Private params:
pos="x1,y1,x2,y2" (position and size)

Public params:
name="str" (name of the object)

Parent: none

<dropdown>  <DD>

Private params:
pos="x1,y1,x2,y2" (position and size)
id="int" (Id)

Public params:
indent="int" (Indention of the text)
edit="1" (for editable text)
text="str" (text)

Parent: widget

<userbutton> <UB>

Note:
For some reason this doesn`t work
Private params:
pos="x1,y1,x2,y2" (position and size)
id="int" (Id)
title="str" (title on the button)

Public params:
upimage=""str" (image when is button up)
downmage=""str" (image when is button down)
colorkey="int" (colorkey for the image)
toggle="1" (toggle-button)
pressed="1" (button will be pressed)
border="int,int,int" (size of border in norm, pressed, high state)
transparency="int,int,int" (transparency in norm, pressed, high state)

Parent : widget

<button> <BT>

Private params:
pos="x1,y1,x2,y2" (position and size)
id="int" (Id)
title="str" (title on the button)

Public params:
upgrad="grad" (gradient when button up)
downgrad="grad" (gradient when button down)
selgrad="grad" (gradient when button selected)

Parent : userbutton

<label> <LL>

Private params:
pos="x1,y1,x2,y2" (position and size)
title="text" (text in the label)

Public params:
align="align" (align of the text = left,center,right)
indent="int" (indention of the text)
icon="str" (icon in the label)

Parent : widget

<gradientwidget> <GW>

Private params:
pos="x1,y1,x2,y2" (position and size)

Public params:
image="str" (filename of the image)
imode="imode" (tile / stretch)
blend="int" (0 - background image fully visible / 255 - gradient fully visible)
gradient="grad" (gradient of the background)

Parent : widget

<staticframe> <SF>

Private params:
pos="x1,y1,x2,y2" (position and size)

Public params:
bimage="str" (name of the image)
transparency="int" (transparency of the drawing object 0 - opaque / 255 - fully transparent)

Parent : gradientwidget

<lineedit> <LE>

Private params:
pos="x1,y1,x2,y2" (position and size)
length="int" (max length of the text)

Public params:
text="str" (text)
readonly="1" (read-only lineedit)
validkeys="str" (list of valid keys)

Parent : staticframe

<maskedit> <ME>

Private params:
pos="x1,y1,x2,y2" (position and size)
length="int" (max length of the text)

Public params:
mask="str" (mask e.g. ##.##.#####)
spacer="char" (witch char to use inspace #)

Parent : lineedit

<progressbar> <PB>

Private params:
pos="x1,y1,x2,y2" (position and size)

Public params:
progress="int" (progress value)

Parent : staticframe

<spinnerbox> <SB>

Private params:
pos="x1,y1,x2,y2" (position and size)

Public params:
value="int" (value)
min="int" (min value)
max="int" (max value)
mask="str" (mask of the value e.g. ##)
Note: min < max - if not, min and max values are not used

Parent : staticframe

<window> <WN>

Private params:
pos="x1,y1,x2,y2" (position and size)
title="str" (window title)
modal="1" (window will be modal)

Public params:
titlecolor="int,int,int" (RGB of the title font color)

Parent : staticframe

<messagebox> <MB>

Private params:
pos="x1,y1,x2,y2" (position and size)
title="str" (window title)
text="str" (window text)
talign="align" (text align - left/center/right)
b1text="str" (text on the button1)
b1pos="x1,y1,x2,y2" (text on the button1)
b2text="str" (text on the button2)
b2pos="x1,y1,x2,y2" (text on the button2)<br<

Public params:
none

Parent : window<br<

<widgetlist> <WL>

Private params:
pos="x1,y1,x2,y2" (position and size)

Public params:
scrollbar="1" (enable scrollbar)

Parent : staticframe

<listbox> <LB>

Private params:
pos="x1,y1,x2,y2" (position and size)<br<

Public params:
multisel="1" (enable multiselect)

Parent : widgetlist

<radiobutton> <RB>

Private params:<br< pos="x1,y1,x2,y2" (position and size)
id="int" (id)
text="str" (text)
group="str" (name of the first radiobutton in the group if this isn`t the first one)

Public params:
pressed="1" (pressed)

Parent : staticframe<br<

<checkbutton> <RB>

Private params:
pos="x1,y1,x2,y2" (position and size)
id="int" (id)
text="str" (text)

Public params:
none

Parent : radiobutton

<scrollbar> <SB>

Private params:
pos="x1,y1,x2,y2" (position and size)
id="int" (id)
dir="int" (direction 0 - horizontal, 1 - vertical)

Public params:
value="int" (value)
wsize="int" (window size)
lsize="int" (l size)
psize="int" (p size)
min="int" (min value)
max="int" (max value)
Note: min < max - if not, min and max values are not used

Parent : staticframe

<slider> <SR>

Private params:
pos="x1,y1,x2,y2" (position and size)
id="int" (id)
dir="int" (direction 0 - horizontal, 1 - vertical)

Public params:
none

Parent : scrollbar

<image> <IM>

Private params:
pos="x1,y1" (position)
iimage="str" (filename of the image)

Public params:
none

Parent : staticframe

DropDown section tags

<dropdownitem>  <DI>

Params:
text="str" (text of the item)

ListBox section tags

<listboxitem>   <LI>

Private params:
height="int" (height of the item)
ltext="str" (text of the item)

Public params:
select="1" (item will be selected)

Parent : scrollbar

<columnitem>    <CI>

Private params:
height="int" (height of the item)
colimns="int" (no. of the columns)

Public params:
none

Parent : listboxitem

ColumnItem section tags

<column>    <CO>

Params:
no="int" (no. of the column)
text="str" (text of the item)
width="int" (width of the column)

Special tags

<style>     <ST>

Use style by widgetname and objectname
Params:<br< widget="str" (name of the widget)
object="str" (name of the object)

<noshow>    <NS>

Do not show parent widget


The ParaGUI Project - Alexander Pipelka