The formatted text is always displayed in a multi-line format.
Internally, the formattedtextcontrol uses the following XML tags to represent formatting embedded within the text:
<formattedtextcontrol name="..."
>
|
|
<font
>
|
The names of the fonts to use when displaying the formatted text |
<normal
>
...
</normal>
|
The font to use for normal text. |
<bold
>
...
</bold>
|
The font to use for bolded text. |
<italic
>
...
</italic>
|
The font to use for italicized text. |
<bolditalic
>
...
</bolditalic>
|
The font to use for bolded, italicized text. |
<title
>
...
</title>
|
The font to use for header text. |
</font>
|
|
<icon
>
|
The names of the icon resources to use in this control |
<link
>
...
</link>
|
The icon to use when link data exists. |
<emptylink
>
...
</emptylink>
|
The icon to use when link data does not exist. |
<chat
>
...
</chat>
|
The icon to use as a trigger for spoken dialogue text. |
</icon>
|
|
<linkicon
>
|
The names of the icons to use when displaying links. |
<link
>
...
</link>
|
The icon to use when link data exists. |
<emptylink
>
...
</emptylink>
|
The icon to use when link data does not exist. |
</linkicon>
|
|
<footer
>
...
</footer>
|
The name of the icon to display beneath the formatted text. |
<selectioncolor
>
...
</selectioncolor>
|
The color to use for text selection, in the form '#aarrggbb'. If alpha is zero or not defined, FF is assumed. |
<empty
>
|
The text to display when the underlying formattedtext value is empty. If no child tags or attributes defined, the enclosed text will be used. |
<text
>
...
</text>
|
Text to display when control is empty. |
<textres
>
...
</textres>
|
String resource to display when control is empty. |
<hidereadonly
>
...
</hidereadonly>
|
Attribute. If exists, the empty text is not displayed when control set to read only status. |
</empty>
|
|
</formattedtextcontrol>
|
|
Returns whether the control contains text or is empty.
Return values
(boolean)
Whether the control is empty
Is called when the control gains the keyboard focus.
Is called when the control loses the keyboard focus.
Is called when the underlying value referenced by the control changes. This may result from changes outside of direct editing by this control. (i.e. via ruleset script or another control accessing same database value)
This function requests the framework to either set or reset the keyboard focus to this control.
Parameters
state (boolean) [optional]
A value of true sets the focus to this control, a false value resets the focus.
When the parameter is omitted (synonymous to passing a nil value), the value is treated as true.