diff -r ab8569330011 -r 46f364ef3f5d org.symbian.wrttools.doc.WRTKit/html/WRTKit_UIElement_Class-GUID-37b82f75-720c-4f54-9769-cda18453ffa3.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/org.symbian.wrttools.doc.WRTKit/html/WRTKit_UIElement_Class-GUID-37b82f75-720c-4f54-9769-cda18453ffa3.html Thu Mar 04 17:06:37 2010 -0800 @@ -0,0 +1,322 @@ + + + + + + + + + + + + + + +WRTKit UIElement Class + + + + + +

+WRTKit UIElement Class

+ +
+ +

+Description

+ + +

+ + The UIElement class is the base class for all user interface elements + such as views and controls. Don't instantiate UIElement directly but rather + use one of its subclasses. +

+ +
+ +
+ +
+ +
+
+ +

+getEventListeners()

+ +
+ +

+Syntax

+ + +
+[Array] UIElement.getEventListeners(void)
+ +
+ +

+Description

+ + +

+ + Allows retrieval of the currently registered event listeners for this user interface element. +

+ +
+ +

+Arguments

+ + +

+ + This method does not take any arguments. +

+ +
+ +

+Return value

+ + +

+ + An array of event listeners currently registered to the user interface element. +

+ +
+ +
+ +
+ +
+ +

+addEventListener()

+ +
+ +

+Syntax

+ + +
+[void] UIElement.addEventListener(String eventType, Function listener)
+ +
+ +

+Description

+ + +

+ + Allows registration of a callback function to a user interface element in order to get + notifications of events in the user interface element. Event registration can be done + for a specific type of event or for all events. +

+ +
+ +

+Arguments

+ + +
    + +
  • + +

    +eventType

    + + + +

    + + The name of the event type the listener should be called for or null if + all event types. The available event type names depend on the actual user + interface element class that this method is caled for. +

    + +

    + + The most common event type names are ActionPerformed for button control clicks, + SelectionChanged for selection controls, FocusStateChanged for all controls to + indicate that focus was gained or lost and FocusedControlChanged for views to + announce that a new control has been brought into (or out of) focus. +

    + + +
  • + +
  • + +

    +listener

    + + + +

    + + The function that should be called when the specified event type occurs. + The function should be defined with a single argument that will receive the + event object. The object has three properties: source, type and value. The + source property specifies the user interface element (e.g. control) from where + the event originated. The type property contains the event type name. The + contents of the value property depends between event types but contains + additional information about the event. For example if the value changes in + a selection control then the value property contains the new value. +

    + + +
  • + +
+ +
+ +

+Return value

+ + +

+ + This method does not return a value. +

+ +
+ +
+ +
+ +
+ +

+removeEventListener()

+ +
+ +

+Syntax

+ + +
+[void] UIElement.removeEventListener(String eventType, Function listener)
+ +
+ +

+Description

+ + +

+ + Allows a specific event listener to be unregistered from a user interface control. +

+ +
+ +

+Arguments

+ + +
    + +
  • + +

    +eventType

    + + + +

    + + The event type name of the listener that should be removed. Use the exact + same event type name as when adding the event listener. +

    + + +
  • + +
  • + +

    +listener

    + + + +

    + + The callback function of the listener that should be removed. +

    + + +
  • + +
+ +
+ +

+Return value

+ + +

+ + This method does not return a value. +

+ +
+ +
+ +
+ +
+ +

+id

+ +
+ +

+Syntax

+ + +
+[String] UIElement.id
+ +
+ +

+Description

+ + +

+ + The id property is a unique identifier for the user interface element. + The identifier is used for the root HTML element in the element hierarchy + that defines the user interface element and is useful for example in + specifying specific CSS rules for a particular user interface element. + The identifier can also be used to recognize the source of an event in an + event callback by accessing the id property of the source property in the + event object passed to the event listener callback. +

+ +
+ +
+ +
+ + + + \ No newline at end of file