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.

Screenshot eines Fensters mit verschiedenen Schaltflächen, einschließlich eines neben reduzierten Steuerelementtexts

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.

Screenshot des vorherigen Fensters, aber mit zwei Zeilen erweitertem Steuerelementtext

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