OnSelChange event

Project: Shell Folders Unit.

Unit: PJShellFolders.

Class: TPJBrowseDialog

Applies to: ~>2.0

type
  TPJBrowseSelChangeEvent = procedure(Sender: TObject; 
    FolderName, DisplayName: AnsiString; var StatusText: AnsiString;
    var OKEnabled: Boolean) of object;

property OnSelChange: TPJBrowseSelChangeEvent;

Description

OnSelChange is triggered whenever the selection in the dialog box changes. This can occur before the dialog is displayed and before the OnInitialise event fires. Write a handler to perform any required processing when the selected folder changes and to update the status text and state of the dialog’s OK button. The OnSelChange event is immediately followed by the OnSelChangeEx event. It is recommended that only one of these events is handled.

The event handler’s parameters are as follows:

• Sender contains a reference to the TPJBrowseDialog component that triggered the event.
• FolderName is the full path name name of newly selected folder (or the empty string if the folder is virtual).
• DisplayName is the text used to display the newly selected folder in the dialog’s tree view.
• StatusText will always be the empty string. Set this value to whatever text should be displayed in the dialog’s status area. Setting StatusText will only have an effect if the Options property includes boStatusText and does not include boNewDlgStyle [~>2.2].
• OKEnabled will be True if the dialog’s OK button is currently enabled and False if it should be disabled. Setting OKEnabled to a different value will change the state of the OK button accordingly. The default state of the OK button depends on whether boDirsOnly is included in the Options property. If boDirsOnly is included in Options then the OK button will be enabled when a physical folder is selected and disabled when a virtual folder is selected.

When OnSelChange is triggered the dialog’s window handle is available via the Handle property.