Informationen zu Taskdialogfeldern
Bei einem Aufgabendialogfeld handelt es sich um ein Dialogfeld zum Anzeigen von Informationen und zum Entgegennehmen einfacher Eingaben des Benutzers. Wie ein Meldungsfeld wird es vom Betriebssystem entsprechend den von Ihnen festgelegten Parametern formatiert. Ein Aufgabendialogfeld verfügt jedoch über viel mehr Funktionen als ein Meldungsfeld.
Hinweis
Taskdialogfelder erfordern das Singlethread-Apartmentmodell (STA).
Teile eines Aufgabendialogfelds
Ein Aufgabendialog besteht aus mehreren Elementen, von denen die meisten optional sind. Die folgende Abbildung zeigt die verschiedenen Teile eines Aufgabendialogfelds.

In der folgenden Abbildung hat der Benutzer auf die Schaltfläche neben dem reduzierten Steuerelementtext geklickt, sodass dort und in der Fußzeile alternativer Text angezeigt wird.

Die Abbildungen zeigen die folgenden Teile:
| Teil | BESCHREIBUNG | TASKDIALOGCONFIG-Mitglied |
|---|---|---|
| Fenstertitel | Beschriftung des Fensters. | pszWindowTitle |
| Hauptsymbol | Ein großes Symbol, das den Zweck des Aufgabendialogfelds andeutet. | hMainIcon oder pszMainIcon |
| Main-Anweisung | Prinzipaltext. | pszMainInstruction |
| Inhalt | Zusätzlicher Text. | pszContent |
| Statusleiste | Eine animierte Leiste, die den Fortschritt einer Aufgabe zeigt. | dwFlags |
| Optionsfelder | Anwendungsdefinierte Optionen für den Benutzer. | pRadioButtons |
| Benutzerdefinierte Schaltfläche | Eine Schaltfläche, die keine der gängigen Schaltflächen ist. Dies kann entweder eine normale Schaltfläche oder, wie in der Abbildung dargestellt, ein Befehlslink mit bis zu zwei Textzeilen sein. | pButtons |
| Schaltfläche "Erweitern/Reduzieren" | Eine Schaltfläche, die verwendet werden kann, um zwischen dem anwendungsdefinierten reduzierten Steuerelementtext (z. B. "Weitere Details anzeigen") und dem erweiterten Steuerelementtext, der in zwei oder mehr Zeilen angezeigt werden kann, umschalten zu können. Wenn der Steuerelementtext erweitert wird, wird der zusätzliche Text in pszExpandedInformation ebenfalls angezeigt, entweder nach dem Inhaltstext oder (wie in der zweiten Abbildung dargestellt) in der Fußzeile. | pszCollapsedControlText und pszExpandedControlText |
| Kontrollkästchen "Überprüfung" | Ein Kontrollkästchen, das von anwendungsdefiniertm Text für einfache Optionen wie "Dieses Dialogfeld nicht mehr anzeigen" begleitet wird. | pszVerificationText |
| Fußzeilensymbol | Ein kleines Symbol, das den Zweck des Fußzeilentexts andeutet. | hFooterIcon oder pszFooterIcon |
| Footertext | Zusätzlicher Text. In den Abbildungen enthält der Text einen Link. | pszFooter |
| Schaltfläche "Allgemein" | Eine Standardschaltfläche; in den Abbildungen die Schaltfläche OK. | dwCommonButtons |