Task Dialog

This section contains information about the programming elements used with a task dialog. A task dialog is similar to, while much more flexible than, a basic message box.

Note  Applications written in managed code can access task dialogs by using a source code library provided by Microsoft. For more information, including downloading instructions, see the Windows API Code Pack for Microsoft .NET Framework on the MSDN Code Gallery.

Overviews

TopicContents
About Task Dialogs

Describes the elements of a task dialog.

 

Functions

TopicContents
TaskDialog

Creates, displays, and operates a task dialog. The task dialog contains application-defined message text and title, icons, and any combination of predefined push buttons. This function does not support the registration of a callback function to receive notifications.

TaskDialogCallbackProc

An application-defined function used with the TaskDialogIndirect function. It receives messages from the task dialog when various events occur.

The PFTASKDIALOGCALLBACK type defines a pointer to this callback function. TaskDialogCallbackProc is a placeholder for the application defined function name.

TaskDialogIndirect

Creates, displays, and operates a task dialog. The task dialog contains application-defined icons, messages, title, verification check box, command links, push buttons, and radio buttons. This function can register a callback function to receive notification messages.

 

Messages

TopicContents
TDM_CLICK_BUTTON

Simulates the action of a button click in a task dialog.

TDM_CLICK_RADIO_BUTTON

Simulates the action of a radio button click in a task dialog.

TDM_CLICK_VERIFICATION

Simulates the action of a verification checkbox click in a task dialog.

TDM_ENABLE_BUTTON

Enables or disables a push button in a task dialog.

TDM_ENABLE_RADIO_BUTTON

Enables or disables a radio button in a task dialog.

TDM_NAVIGATE_PAGE

Recreates a task dialog with new contents, simulating the functionality of a multi-page wizard.

TDM_SET_BUTTON_ELEVATION_REQUIRED_STATE

Specifies whether a given task dialog button or command link should have a User Account Control (UAC) shield icon; that is, whether the action invoked by the button requires elevation.

TDM_SET_ELEMENT_TEXT

Updates a text element in a task dialog.

TDM_SET_MARQUEE_PROGRESS_BAR

Indicates whether the hosted progress bar should be displayed in marquee mode.

TDM_SET_PROGRESS_BAR_MARQUEE

Starts and stops the marquee display of the progress bar, and sets the speed of the marquee.

TDM_SET_PROGRESS_BAR_POS

Sets the current position for a progress bar.

TDM_SET_PROGRESS_BAR_RANGE

Sets the minimum and maximum values for the hosted progress bar.

TDM_SET_PROGRESS_BAR_STATE

Sets the current state of the progress bar.

TDM_UPDATE_ELEMENT_TEXT

Updates a text element in a task dialog.

TDM_UPDATE_ICON

Refreshes the icon of a task dialog.

 

Notifications

TopicContents
TDN_BUTTON_CLICKED

Sent by a task dialog when the user selects a button or command link in the task dialog. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

TDN_CREATED

Sent by a task dialog after the task dialog has been created and before it is displayed. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

TDN_DESTROYED

Sent by a task dialog when it is destroyed and its window handle is no longer valid. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

TDN_DIALOG_CONSTRUCTED

Sent by a task dialog after the task dialog has been created and before it is displayed. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

TDN_EXPANDO_BUTTON_CLICKED

Sent by a task dialog when the user clicks on the task dialog's expando button. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

TDN_HELP

Sent by a task dialog when the user presses F1 on the keyboard while the task dialog has focus. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

TDN_HYPERLINK_CLICKED

Sent by a task dialog when the user clicks a hyperlink in the task dialog content. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

TDN_NAVIGATED

Sent by a task dialog when a navigation has occurred. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

TDN_RADIO_BUTTON_CLICKED

Sent by a task dialog when the user selects a button or command link in the task dialog. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

TDN_TIMER

Sent by a task dialog approximately every 200 milliseconds. This notification code is sent when the TDF_CALLBACK_TIMER flag has been set in the dwFlags member of the TASKDIALOGCONFIG structure that was passed to the TaskDialogIndirect function. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

TDN_VERIFICATION_CLICKED

Sent by the task dialog when the user clicks the task dialog verification check box. This notification code is received only through the task dialog callback function, which can be registered using the TaskDialogIndirect method.

 

Structures

TopicContents
TASKDIALOG_BUTTON

Contains information used to display a button in a task dialog. The TASKDIALOGCONFIG structure uses this structure.

TASKDIALOGCONFIG

Contains information used to display a task dialog. The TaskDialogIndirect function uses this structure.

 

 

 

Community Additions

ADD
Show:
© 2014 Microsoft