Objects to Use for Event Listeners

Object

Description

GainFocusListener

Generates a user-initiated event when a user interface object gains focus.

For example, if you want to generate a user-initiated event when an entry field gains focus because the user selects the entry field, add a GainFocusListener object as a child of the Entry object.

The GainFocusListener object does not have any properties.

LoseFocusListener

Generates a user-initiated event when a user interface object loses focus.

For example, if you want to generate a user-initiated event when an entry field loses focus because the user stops selecting the entry field by selecting another user interface control, add a LoseFocusListener object as a child of the Entry object.

The LoseFocusListener object does not have any properties.

PostEditListener

Generates a user-initiated event after a user edits an object.

Note:

In the case of keyboard entry, a new event is generated for each character typed or deleted.

For example, if you want to generate a user-initiated event after a user types an entry in a SearchEntry object, add a PostEditListener object as a child of the SearchEntry object.

The PostEditListener object does not have any properties.

PreEditListener

Generates a user-initiated event when a user is about to edit an object.

For example, if you want to generate a user-initiated event when a user is about to type text in a SearchEntry object, add a PreEditListener object as a child of the SearchEntry object.

The PreEditListener object does not have any properties.

TriggerListener

Generates a user-initiated event after a user uses an object.

For example, if you want to generate a user-initiated event after a user presses a Button object, add a TriggerListener object as a child of the Button object.

Note:

If you add a TriggerListener as the child of an Image object, the image acts as a button.

The TriggerListener object does not have any properties.

SwipeListener

Generates a user-initiated event when a user swipes to the left or right.

A SwipeListener is the child of a View object.

For information about setting properties for the SwipeListener object, see SwipeListener Properties.

CompletedEditListener

Listens for, when a user edits an object, for example an entry field, and generates an event when the user ends the editing. End of editing means closing the keyboard or focusing another UI element.

The CompletedEditListener object does not have any properties.

RowSelectionListener

Generates a user-initiated event when a user selects a row.

A RowSelectionListener is the child of a ContentProvider object.