Docs GODI Archive
Projects Blog Knowledge

Look up function:

(e.g. "List.find" or "keysym")
More options

The UI language
 ui:alist-value and ui:alist-item
 ui:dyn-enum-value and ui:dyn-enum-item
 ui:enum-value and ui:enum-item
 ui:enumeration and ui:enum
 ui:text and ui:password
 t:*, q:*, and p:*
 Dot notation (v1.v2)
The element ui:use

This element instantiates a template. For an overview, see the chapter about Templates.


Level: Control structure

<!ELEMENT ui:use ( ui:param )* >

<!ATTLIST ui:use
          template NMTOKEN #REQUIRED>

  • template: Names the template to instantiate. Note that the current language of the dialog may also influence which template is selected (see below).

Sub elements

The ui:param elements define the actual values for the lexical parameters


If a certain language is selected for the dialog, this also affects the template system. In particular, it is first checked if the used template is defined for this language, and if so, this version of the template will be used. Otherwise, it is checked whether there is a template without xml:lang attribute, and if it can be found, this version will be used.

For more information, see the chapter about Internationalization.

The t namespace

Because ui:use is a quite long notation, there are two ways to abbreviate it. Instead of

<ui:use template="x">
  <ui:param name="p1">t1</ui:param>
  <ui:param name="pN">tN</ui:param>
you can also write

Furthermore, the parameters can also be passed by attributes if they only consist of unstructured text:

<t:x p1="t1" ... pK="tK">
The q namespace

The other way to abbreviate ui:use is the q namespace. Instead of writing

<ui:use template="x">
  <ui:param name="p1">t1</ui:param>
  <ui:param name="pN">tN</ui:param>
  <ui:param name="body">tBODY</ui:param>
(note the fixed name body) it is also possible to call the template by:

<q:x p1="t1" ... pK="tK">

See Templates.

This web site is published by Informatikbüro Gerd Stolpmann
Powered by Caml