[Overview][Types][Classes][Procedures and functions][Index] | Reference for unit 'TaskDlgEmulation' (#lcl)

# TLCLTaskDialog

[Properties (by Name)] [Methods (by Name)] [Events (by Name)]

Implements an emulated (non-native) task dialog form.

## Declaration

Source position: taskdlgemulation.pp line 61

`type TLCLTaskDialog = class(TForm)`
`protected`
`procedure SetupControls;` |  | Configures and initializes properties and controls used on the emulated task dialog form.
`public`
`procedure KeyDown(); override;` |  | Implements the OnKeyDown event handler for the task dialog.
`constructor CreateNew(); override;` |  | Alternate constructor for the class instance.
`destructor Destroy; override;` |  | Destructor for the class instance.
`procedure AfterConstruction; override;` |  | Performs actions needed when a new instance of the class has been created.
`procedure DoShow; override;` |  | Performs actions needed when the dialog form is initially displayed.
`function Execute();` |  | Configures and displays the emulated task dialog and returns the modal result value.
`end;`

## Inheritance

`TLCLTaskDialog` |  | Implements an emulated (non-native) task dialog form.
`TForm` |  | Implements a form used in an LCL application.
`TCustomForm` |  | The base type for TForm classes.
`TCustomDesignControl` |  | Provides a designer surface for scaling and layout of its child controls.
`TScrollingWinControl` |  | Implements a windowed control with scroll bars.
`TCustomControl` |  | The base class for windowed controls which paint themselves.
`TWinControl` |  | Implements a windowed control which can contain other child controls.
`TControl` |  | The base class for visible controls.
`TLCLComponent` |  | The base class for LCL components which have an associated widget.
`TComponent`
?
`TObject`

## Description

TLCLTaskDialog is a TForm descendant which implements the dialog form displayed when an emulated (non-native) TTaskDialog is executed. It imitates the content, layout, and behavior for the dialog displayed for the Windows Task Dialog API.

It provides support for use of TTaskDialog on platforms which do not implement the Task Dialog API - including Windows versions prior to Windows Vista. Most of the properties, methods, and members in the class are declared as private and are available to the methods in the class instance. Application do not normally create an instance of TLCLTaskDialog; it is created at run-time when TTaskDialog calls its Execute method.

TLCLTaskDialog allows the dialog form to be configured at run-time using the settings specified in the TTaskDialog passed as the Owner of the form. The Execute methods handles initializing the form instance, displaying the dialog, capturing the modal result value, and returning changes to the TTaskDialog for the emulated task dialog form.

## Version info

Added in LCL version 4.0.

## See also

TLCLTaskDialog.CreateNew |  | Alternate constructor for the class instance.
TLCLTaskDialog.Execute |  | Configures and displays the emulated task dialog and returns the modal result value.
ExecuteLCLTaskDialog |  | Executes an emulated task dialog for using the specified arguments.
TTaskDialog.Flags |  | Set of options enabled for the Task dialog.
TForm |  | Implements a form used in an LCL application.