OnSelChangeEx event

Project: Shell Folders Unit.

Unit: PJShellFolders.

Class: TPJBrowseDialog

Applies to: ~>2.0

type
  TPJBrowseSelChangeEventEx = procedure(Sender: TObject;
    PIDL: PItemIDList; var StatusText: AnsiString;
    var OKEnabled: Boolean) of object;

property OnSelChangeEx: TPJBrowseSelChangeEventEx;

Description

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

The event handler’s parameters are as follows:

• Sender contains a reference to the TPJBrowseDialog component that triggered the event.
• PIDL is the PIDL of the newly selected folder. Note: This PIDL should be copied if it is to be retained beyond the life of the event handler and the copy should ultimately be freed using the Shell’s allocator.
• 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]. Setting the status text in this event handler will override any status text set in the OnSelChange event handler.
• OKEnabled will be True if the dialog’s OK button is currently enabled and False if it is 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 OnSelChangeEx is triggered the dialog’s window handle is available via the Handle property.