Packages
Comm
DB
Debug
Input
Interface
Module
Token
User

Objects
bitmapwidget
databasenode
dragdata
textwidget
tokeninstance
widget
widgetcontainer

Elements
buttoncontrol
categoryselectioncontrol
chatentry
chatwindow
databasecontrol
diecontrol
diefield
formattedtextcontrol
formattedtextfield
genericcontrol
imagecontrol
numbercontrol
numberfield
portraitselectioncontrol
script
scrollbarcontrol
scrollercontrol
stringcontrol
stringfield
subwindow
textbasecontrol
tokenbag
tokencontrol
tokenfield
windowclass
windowcontrol
windowinstance
windowlist
windowreferencecontrol
windowreferencefield

Components
categoryselectionsettings
customdie
desktopframe
die
distance
font
framedef
hotkeybar
icon
imageupdatefolder
imagesettings
importinfo
includefile
panel
portraitset
properties
replaces
template
textsettings
tokenroot
tooltip
getEmptyText
onValueChanged
setEmptyText



Inherits windowcontrol textbasecontrol
Context windowinstance

Strings are controlled with stringcontrol objects.



Definition

<stringcontrol name="..." >
<default > If present, new controls will use this value as their default, instead of the empty string. If no child tags or attributes defined, the enclosed text will be used.
<text > ... </text> Text value to use when underlying database node initialized.
<textres > ... </textres> String resource to use when underlying database node initialized.
</default>
<readonly /> Makes the string unmodifiable.
<static > Makes the string unmodifiable, and the value on the control is set to the value specified. If no child tags or attributes defined, the enclosed text will be used.
<text > ... </text> Text value to set this control to.
<textres > ... </textres> String resource to set this control to.
</static>
<empty > If the string is empty, the value of the empty tag is written in the field. If no child tags or attributes defined, the enclosed text will be used.
<text > ... </text> Text value to use when the control is empty.
<textres > ... </textres> String resource to use when the control is empty.
</empty>
<nodrag /> Disables drag operations originating from the string.
<nodrop /> Dropping strings in the field do not modify the value of the string.
<nodragselect /> Disables text selection by mouse dragging.
<delaykeyupdate /> If present and editing the value of this control using the keyboard, changes won't be written to the database and update event functions will not be called until the focus is moved away from the control.
</stringcontrol>


Interface

getEmptyText

function getEmptyText( )

Retrieve the text to display in the control when the underlying data is the empty string.

Return values

(string)
The value of the empty text display string for this control.

onValueChanged

event function onValueChanged( )

Is called when the value of the string inside the control changes. This may result from finishing the editing of the string or the value changing externally from the control.


setEmptyText

function setEmptyText( value )

Set the text to display in the control when the underlying data is the empty string.

Parameters

value(string)
The new value for the empty text display string


'Fantasy Grounds' is a trademark of SmiteWorks Ltd. All other trademarks are the property of their respective owners.
2004-2010 SmiteWorks Ltd. ALL RIGHTS RESERVED.
Privacy policy