Events associated with Edit controls

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Edit control

Events associated with Edit controls

Default events

Optional events

See also

Events associated with Edit controls

Default events

Events managed by WEBDEV

WEBDEV manages the following events by default (order of appearance in the code editor):

Event	Runtime condition

Initializing (Server code)	Executed when the page is opened.
Enter (Browser code)	Executed when the control gains focus.
Whenever modifying (Browser code)	Executed whenever the content of the control is modified (entering or deleting a character, for example). This makes it possible to check the input or show suggestions as the user types, without returning to the server.
Leave after changes (Browser code)	Executed when moving from one control to another (selecting another control with the mouse, etc.) after the content of the control was modified (entering or deleting a letter, for example).
Exit (Browser code)	Executed when moving from one control to another (selecting another control with the mouse, etc.).
Add a token (Browser code)	This event is only available for "Text token" Edit controls. Executed each time the user adds a token in the control. The token is added when a character specified as a token separator is used. If this event returns: True, the token is added in the Edit control, False, the token is not added. The input area of the control is cleared. This event is not executed if the addition is done programmatically.
Click on a token (Browser code)	This event is only available for "Text token" Edit controls. Executed when a token in an Edit control is clicked.
Delete a token (Browser code)	This event is only available for "Text token" Edit controls. Executed when the user deletes a token by clicking the "X" icon. If this event returns: True, the token is deleted from the Edit control, False, the token is not deleted from the Edit control. This event is not executed if the deletion was done programmatically.

Remark: Only the browser codes are available in a static page.

Optional events

Several optional events are supported. To add an optional event:

Select the desired control.
Display the code window of this control (F2 key).
Click the link "Add other events to xxx" at the bottom of the window code, after the last event.
All the optional events available for the control are displayed.
Check the optional event to add and validate.
Remark: You can select several optional events.
The selected optional event is automatically added to the events managed by the control.

To disable an optional event, simply perform the same operations to display the list of optional events. Then simply uncheck the optional events to delete.
Remark: If the disabled code contains WLanguage code, this code is automatically deleted.

You can manage the following aspects, for example:

the mouse hover over the control,
left mouse button down, up, double click,
right mouse button down, up, double click,
the mouse wheel, etc.

New in version 28

Event "Selection of a value in the assisted input list".

The optional event "Selection of a value in the assisted input list" corresponds to the event that will be executed when the user selects an item in the assisted input list. To simplify its handling, this event is associated with an Procedure:

PROCÉDURE SélectionSaisieAssistée(MaSélection is AssistedInput)

The Variable of type AssistedInput contains the characteristics of the row selected in the assisted entry (Label displayed and corresponding stored value).

This event allows for example:

to know the selected option.
to change the value displayed in the edit control after the selection.

// Add a suggestion
_AutocompleteSuggestion is AssistedInput
_AutocompleteSuggestion.Caption = "Alpharetta, GA 30022"
_AutocompleteSuggestion.StoredValue = 30022
AssistedInputAdd(EDT_PostalCode, _AutocompleteSuggestion)

// -- Event "Select a value in the list of input suggestions"
PROCEDURE Selection(MySelection is AssistedInput)
EDT_PostalCode = MySelection.StoredValue