SftDirectory.SelectionFinal Event	Softel vdm, Inc.

A new file/folder is selected (and remains selected).

Syntax       

		VB.NET	Private Sub object_SelectionFinal(ByVal sender As Object, ByVal e As EventArgumentType) Handles object.SelectionFinal
		VB	Private Sub object_SelectionFinal()
		C#.NET	void object_SelectionFinal(object sender, EventArgumentType e);
		VC++	void OnSelectionFinalobject();
		C	HRESULT OnSelectionFinalobject();
		Delphi	procedure objectSelectionFinal(Sender: TObject);

object

A SftDirectory object.

Comments

The SelectionFinal event occurs when a new file/folder is selected (and remains selected).

The SelectionChange event indicates that a selection has changed, but is not necessarily the final choice made by the user.  The SelectionFinal event occurs once the selection has been made permanent.  The distinction is made for combo box style controls (see ControlStyle property), which allow a selection change to occur in the dropdown list portion, but later canceled using the ESCAPE key.  The SelectionFinal event would occur to signal the actual (final) selection once the dropdown list is closed.

Applications should generally use the SelectionFinal event, instead of the SelectionChange event.  The SelectionChange event can be used to update  a status bar or help information as a user makes selections in a combo box before they become permanent.

The SelectionCount property contains the number of currently selected folders.  The selected folders can be retrieved using the Selection property.

The MultiSelect property defines whether only one or multiple folders can be selected at a time.  Combo box style controls (see ControlStyle property) support single selection only.