II. GUI Basics
Chapter 10. Widgets Attribute
Clear Text
Method signature
'clearLabel' is a method that is used with 'action' event to clear text in the widget, button, edit,
or other widgets containing text (have 'setLabel' attribute applied).
addActionTarget = "
[String] widget name,
[Constant] event,
[clearLabel] execute method"
[String] is the name of the widget
[Constant] the event to listen on
[clearLabel] the method signature
Examples
clearLabel is achieved through 'action' event.
An action is a higher level event abstraction.
It is triggered by different lower level events.
The button gets the action Event invoked when a
mouse released event occurs WHILE the mouse is still
within the boundaries of the button control
OR
it is invoked on a
key released event WHILE the button still is in focus.
To demostrate the action event we will create a clear an Edit control.
<Widget setShape="0,0,100,80">
<Edit setShape="10,10,80,25" setName="name"
addActionTarget="name,action,clearLabel=''"/>
<Button setShape="10,40,80,25" setLabel="Clear"
addActionTarget="name,action,clearLabel=''"/>
</Widget>
The Edit widget, 'name', will clear its text (if 'Enter' key is hit)
The Button widget will clear the Edit 'name's text
Back
Next