Movatterモバイル変換

[0]ホーム
URL:

Skip to main content

This browser is no longer supported.

Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.

Download Microsoft EdgeMore info about Internet Explorer and Microsoft Edge
Table of contentsExit editor mode

About Task Dialogs

Feedback

In this article

A task dialog is a dialog box that can be used to display information and receive simple input from the user. Like a message box, it is formatted by the operating system according to parameters you set. However, a task dialog has many more features than a message box.

Note

Task dialogs require the single-threaded apartment (STA) model.

 

Parts of a Task Dialog

A task dialog consists of several elements, most of which are optional. The following illustration shows the various parts of a task dialog.

screen shot of a window showing various buttons, including one next to collapsed control text

In the following illustration, the user has clicked the button beside the collapsed control text, causing alternative text to be displayed there and in the footer.

screen shot of the previous window, but with two lines of expanded control text

The illustrations show the following parts:

PartDescriptionTASKDIALOGCONFIG member
Window titleCaption of the window.pszWindowTitle
Main iconA large icon that signifies the purpose of the task dialog.hMainIcon orpszMainIcon
Main instructionPrincipal text.pszMainInstruction
ContentExtra text.pszContent
Progress barAn animated bar that shows the progress of some task.dwFlags
Radio buttonsApplication-defined options for the user.pRadioButtons
Custom buttonA button that is not one of the common buttons. This can be either a normal button or, as shown in the illustration, a command link with up to two lines of text.pButtons
Expand/collapse buttonA button that can be used to toggle between the application-defined collapsed control text (such as "See more details") and the expanded control text, which can be on two or more lines. When the control text is expanded, the additional text inpszExpandedInformation is also shown, either after the content text, or (as shown in the second illustration) in the footer.pszCollapsedControlText andpszExpandedControlText
Verification check boxA checkbox, accompanied by application-defined text, for simple choices such as "Do not show this dialog again."pszVerificationText
Footer iconA small icon that signifies the purpose of the footer text.hFooterIcon orpszFooterIcon
Footer textAdditional text. In the illustrations, the text contains a hyperlink.pszFooter
Common buttonA standard button; in the illustrations, the OK button.dwCommonButtons

 

 

 

Feedback

Was this page helpful?

YesNoNo

Need help with this topic?

Want to try using Ask Learn to clarify or guide you through this topic?

Suggest a fix?
  • Last updated on

In this article

Was this page helpful?

YesNo
NoNeed help with this topic?

Want to try using Ask Learn to clarify or guide you through this topic?

Suggest a fix?