Events
Apr 8, 3 PM - May 28, 7 AM
Sharpen your AI skills and enter the sweepstakes to win a free Certification exam
Register now!Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
| Topic | Contents |
|---|---|
| About Task Dialogs | Describes the elements of a task dialog. |
| Topic | Contents |
|---|---|
| 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. |
| Topic | Contents |
|---|---|
| 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. |
| Topic | Contents |
|---|---|
| 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. |
| Topic | Contents |
|---|---|
| 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. |