SftDirectory 2.5

SftDirectory.SelectionChange Event

Softel vdm, Inc.

A new file/folder is selected.

Syntax       

VB.NET

Private Sub object_SelectionChange(ByVal sender As Object, ByVal e As EventArgumentType) Handles object.SelectionChange

VB

Private Sub object_SelectionChange()

C#.NET

void object_SelectionChange(object sender, EventArgumentType e);

VC++

void OnSelectionChangeobject();

C

HRESULT OnSelectionChangeobject();

Delphi

procedure objectSelectionChange(Sender: TObject);

object

A SftDirectory object.

Comments

The SelectionChange event occurs when a new file/folder is 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.


Feedback / comments / error reports for this topic
© 2003, 2008 - Softel vdm, Inc. - www.softelvdm.com