Eventsvoid onActivate ()
An event-handler callback function, called when the element acquires the keyboard focus.
Called when the user gives the control the keyboard focus by clicking it or tabbing into it.
void onChange ()
An event-handler callback function, called when the user has finished dragging the position indicator, or has clicked the control.
void onChanging ()
An event-handler callback function, called when the content of the element is in the process of changing
The handler is called for any motion of the position indicator while this control has the input focus.
void onDeactivate ()
An event-handler callback function, called when the element loses the keyboard focus.
Called when the user moves the keyboard focus from the previously active control to another control.
void onDraw ()
An event-handler callback function, called when the window is about to be drawn.
Allows the script to modify or control the appearance, using the control's associated ScriptUIGraphics object. Handler takes one argument, a DrawState object.
void onShortcutKey ()
An event-handler callback function, called when the element's shortcutKey sequence is typed in the active window.
In Windows only.
InstancesBoolean addEventListener (eventName:
String, handler:
Function[, capturePhase:
Boolean=false])
Registers an event handler for a particular type of event occuring in this element.
Parameter | Type | Description |
eventName | String | The name of the event.
Event names are listed in the JavaScript Tools Guide.
|
handler | Function | The function that handles the event.
This can be the name of a function defined in the extension, or a locally defined handler function to be executed when the event occurs. A handler function takes one argument, the UIEvent object.
|
capturePhase | Boolean | When true, the handler is called only in the capturing phase of the event propagation. (default: false) Default is false, meaning that the handler is called in the bubbling phase if this object is an ancestor of the target, or in the at-target phase if this object is itself the target. |
Event dispatchEvent ()
Simulates the occurrence of an event in this target.
A script can create a UIEvent object for a specific event and pass it to this method to start the event propagation for the event.
void hide ()
Hides this element.
void notify ([eventName:
String])
Sends a notification message, simulating the specified user interaction event.
Parameter | Type | Description |
eventName | String | The name of the control event handler to call.
One of: onClick, onChange, onChanging. By default, simulates the onChange event for an edittext control, an onClick event for controls that support that event.
(Optional) |
Boolean removeEventListener (eventName:
String, handler:
Function[, capturePhase:
Boolean=false])
Unregisters an event handler for a particular type of event occuring in this element.
All arguments must be identical to those that were used to register the event handler.
Parameter | Type | Description |
eventName | String | The name of the event. |
handler | Function | The function that handles the event. |
capturePhase | Boolean | Whether to call the handler only in the capturing phase of the event propagation. (default: false) |
void show ()
Shows this element.
When a window or container is hidden, its children are also hidden, but when it is shown again, the children retain their own visibility states.
|