SelChange

SelChange() Event

Called when a new item is selected in the drop down portion of the control

Applies to: Grid , KCMLEdit

SelChange() Event

Occurs when a node is selected or deselected

Applies to: Tree

Introduced in KCML version 5.02

SelChange

Lists

This event handler is called each time the current selection changes in a drop down listbox associated with an edit control. This is usually due to the user picking from the list but it can also be invoked when

• items are programmatically added to the list with .Add() and they happen to agree with the text currently in the edit control
• the currently selected item is programmatically removed from the list with Delete()
• the text$ property is changed and a similar match occurs

For this, and other reasons to do with change of focus, the use of this event is strongly discouraged and you are advised to set the ValidateSelChange property instead. This causes a Validate() event to be triggered only when the user makes a selection either by entering text in the edit control or by selecting from the list and it can't be triggered by the action of the program.

The event handler can determine the item selected with the Index property.

Trees

This event handler is also called each time an item is selected within a tree. If the item is selected using the mouse and there is a LeftClick() event handler as well, then only the LeftClick() and not the SelChange() event will be generated. Using the cursor keys will still generate SelChange() events.

See also

Grid methods, properties and events. KCMLEdit methods, properties and events. Tree methods, properties and events.