Common Options

This section describes the attributes that most of the tags have in common.

Attributes

    backgroundcolor
    fontbold (not available)
    fontitalic (not available)
    fontname (not available)
    fontsize (not available)
    fontunderline (not available)
    foregroundcolor
    id (required)
    oncreate (false)
    ondestroy (false)
    popup
    position (center)
    state (enabled)

Description of attributes

backgroundcolor

The backgroundcolor option contains the color that is used as the backgroundcolor of the element. Currently supported colors are: black, white, green, red, yellow, blue, gray, magenta, cyan and brown. The backgroundcolor attribute is used to set the bg-color property of the element.

fontbold

This attribute indicates whether the font of the element must be bold. Allowed values are true and false. This attribute is not supported by PLUG for AppBuilder.

fontitalic

This attribute indicates whether the font of the element must be italic. Allowed values are true and false. This attribute is not supported by PLUG for AppBuilder.

fontname

The fontname specifies the name of the font that has to be used for the text in the element. Due to the differences in fonts on the platforms we only distinct between serif, sansserif and monospace. This attribute is not supported by PLUG for AppBuilder.

fontsize

The fontsize indicates the size of the font in points that is used for the text of the element. This attribute is not supported by PLUG for AppBuilder.

fontunderline

The fontunderline indicates whether the text of the element should be underlined. Allowed values are the booleans true and false. This attribute is not supported by PLUG for AppBuilder.

foregroundcolor

The foregroundcolor option contains the color that is used as the foregroundcolor of the element. Currently supported colors are: black, white, green, red, yellow, blue, gray, magenta, cyan and brown. This attribute is used to change the fg-color property of the element, that is the font color. This doesn't work with elements with no text.

id

The id attribute specifies the unique id of the object. The id attribute is required. The value of the id attribute should consist of lowercase characters. The attribute id of the window and application tag should match the file names without the ".xml" extension. For other elements the id attribute is used to set the element's name.

oncreate

If this attribute has the value true then an oncreate event will be created in the interface code and a section for the event code will be created in the codeframework of the window this element is in. Allowed values for this attribute are true and false.

An 'aftercreate' connection is inserted for the element.

ondestroy

If this attribute has the value true then an ondestroy event will be created in the interface code and a section for the event code will be created in the codeframework of the window this element is in. Allowed values for this attribute are true and false.

A 'destroy' connection is inserted for the element.

popup

The popup attribute refers to an existing popup menu that is used as popup menu for the element. The value of this attribute is the value of the id attribute of the popupmenu. Because only panels can have popup menus assigned to them, for non-panel elements an extra panel with the same size of the element is inserted below the element. The popup value is used to set the menu property of the (underlying) panel.

position

The position attribute is used to specify the position of the element when the layout style of the parent is the borderlayout. It can have the following values: left, right, top, bottom and center. The default value is center. The position attribute is ignored when the element's parent doesn't have a border layout. For more information on the layout click here.

state

The state attribute indicates whether the element is enabled or disabled in the gui. The default value is enabled. This value is used to the corresponding enabled property, which is set to "true" when state="enabled", otherwise it is set to "false"