Skip to main content

TcxShellExecuteItemEvent Type

The procedural type for shell item execution events.

Declaration

TcxShellExecuteItemEvent = procedure(Sender: TObject; APIDL: PItemIDList; var AHandled: Boolean) of object;

Parameters

Name Type Description
Sender TObject

Provides access to the shell control that raised the shell item execution event. Cast the Sender property value to the corresponding shell control class to access its public members.

APIDL PItemIDList

The pointer to the item identifier list (PIDL) of the activated shell item.

AHandled Boolean

If True, the event handler prevents execution of the application associated with the target shell item (APIDL). if False, the associated application successfully launches for the target shell item.

Remarks

The shell item execution event occurs before the associated application launches for the file shell item (APIDL) activated by a double-click or the Enter keystroke.

The following public API members reference the TcxShellExecuteItemEvent procedural type:

TcxCustomShellListView.OnExecuteItem
Occurs before the default associated program is launched for the file shell item activated by pressing the Enter key or by double-clicking the mouse.
TdxCustomShellListView.OnExecuteItem
Allows you to prevent execution of applications associated with certain file types when a user opens a file.
See Also