Info zu Aufgabendialogen

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 Features als ein Meldungsfeld.

Hinweis

Aufgabendialoge erfordern das Sta-Modell (Singlethreaded Apartment).

 

Teile eines Vorgangsdialogfelds

Ein Aufgabendialogfeld besteht aus mehreren Elementen, von denen die meisten optional sind. Die folgende Abbildung zeigt die verschiedenen Teile eines Vorgangsdialogfelds.

Screenshot eines Fensters mit verschiedenen Schaltflächen, einschließlich einer neben reduziertem Steuerelementtext

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

Screenshot des vorherigen Fensters, jedoch mit zwei Zeilen erweitertem Steuerelementtext

Die Abbildungen zeigen die folgenden Teile:

Teil BESCHREIBUNG TASKDIALOGCONFIG-Member
Fenstertitel Beschriftung des Fensters. pszWindowTitle
Hauptsymbol Ein großes Symbol, das den Zweck des Aufgabendialogfelds angibt. hMainIcon oder pszMainIcon
Hauptanweisung Prinzipaltext. pszMainInstruction
Inhalt Zusätzlicher Text. pszContent
Statusleiste Eine animierte Leiste, die den Fortschritt einer Aufgabe anzeigt. dwFlags
Optionsfelder Anwendungsdefinierte Optionen für den Benutzer. pRadioButtons
Benutzerdefinierte Schaltfläche Eine Schaltfläche, die nicht zu den allgemeinen Schaltflächen gehört. 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 von der Anwendung definierten reduzierten Steuerelementtext (z. B. "Weitere Details anzeigen") und dem erweiterten Steuerelementtext umzuschalten, der sich in zwei oder mehr Zeilen befinden kann. Wenn der Steuerelementtext erweitert wird, wird auch der zusätzliche Text in pszExpandedInformation 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 mit anwendungsdefiniertem Text für einfache Optionen wie "Dieses Dialogfeld nicht erneut anzeigen" pszVerificationText
Fußzeilensymbol Ein kleines Symbol, das den Zweck des Fußzeilentexts angibt. 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