Aufgabendialogfeld

Artikel
06/13/2023

Dieser Abschnitt enthält Informationen zu den Programmierelementen, die in einem Aufgabendialogfeld verwendet werden. Ein Aufgabendialogfeld ist ähnlich wie ein einfaches Meldungsfeld, obwohl es viel flexibler ist.

Übersichten

Thema	Inhalte
Informationen zu Aufgabendialogfeldern	Beschreibt die Elemente eines Aufgabendialogfelds.

Functions

Thema	Inhalte
TaskDialog	Erstellt, zeigt ein Aufgabendialogfeld an und betreibt es. Das Aufgabendialogfeld enthält anwendungsdefinierten Nachrichtentext und -titel, Symbole und eine beliebige Kombination vordefinierter Schaltflächen. Diese Funktion unterstützt die Registrierung einer Rückruffunktion zum Empfangen von Benachrichtigungen nicht.
TaskDialogCallbackProc	Eine anwendungsdefinierte Funktion, die mit der TaskDialogIndirect-Funktion verwendet wird. Es empfängt Nachrichten aus dem Aufgabendialogfeld, wenn verschiedene Ereignisse auftreten. Der PFTASKDIALOGCALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. TaskDialogCallbackProc ist ein Platzhalter für den von der Anwendung definierten Funktionsnamen.
TaskDialogIndirect	Erstellt, zeigt ein Aufgabendialogfeld an und betreibt es. Das Aufgabendialogfeld enthält anwendungsdefinierte Symbole, Nachrichten, Titel, Überprüfung, Befehlslinks, Schaltflächen und Optionsfelder. Diese Funktion kann eine Rückruffunktion registrieren, um Benachrichtigungen zu empfangen.

Nachrichten

Thema	Inhalte
TDM_CLICK_BUTTON	Simuliert die Aktion eines Schaltflächenklicks in einem Aufgabendialogfeld.
TDM_CLICK_RADIO_BUTTON	Simuliert die Aktion eines Optionsfeldklicks in einem Aufgabendialogfeld.
TDM_CLICK_VERIFICATION	Simuliert die Aktion eines Überprüfungskontrollkästchens, auf das in einem Aufgabendialogfeld geklickt wird.
TDM_ENABLE_BUTTON	Aktiviert oder deaktiviert eine Drucktaste in einem Aufgabendialogfeld.
TDM_ENABLE_RADIO_BUTTON	Aktiviert oder deaktiviert ein Optionsfeld in einem Aufgabendialogfeld.
TDM_NAVIGATE_PAGE	Erstellt ein Aufgabendialogfeld mit neuen Inhalten neu und simuliert die Funktionalität eines Mehrseiten-Assistenten.
TDM_SET_BUTTON_ELEVATION_REQUIRED_STATE	Gibt an, ob eine bestimmte Taskdialogschaltfläche oder ein Befehlslink über ein Schildsymbol für die Benutzerkontensteuerung (User Account Control, UAC) verfügen soll; d. h., ob die von der Schaltfläche aufgerufene Aktion eine Erhöhung erfordert.
TDM_SET_ELEMENT_TEXT	Updates ein Textelement in einem Aufgabendialogfeld.
TDM_SET_MARQUEE_PROGRESS_BAR	Gibt an, ob die gehostete Statusleiste im Festzeltmodus angezeigt werden soll.
TDM_SET_PROGRESS_BAR_MARQUEE	Startet und stoppt die Anzeige des Festzelts der Statusleiste und legt die Geschwindigkeit des Festzelts fest.
TDM_SET_PROGRESS_BAR_POS	Legt die aktuelle Position für einen Statusbalken fest.
TDM_SET_PROGRESS_BAR_RANGE	Legt die Mindest- und Höchstwerte für die gehostete Statusleiste fest.
TDM_SET_PROGRESS_BAR_STATE	Legt den aktuellen Status der Statusleiste fest.
TDM_UPDATE_ELEMENT_TEXT	Updates ein Textelement in einem Aufgabendialogfeld.
TDM_UPDATE_ICON	Aktualisiert das Symbol eines Aufgabendialogfelds.

Benachrichtigungen

Thema	Inhalte
TDN_BUTTON_CLICKED	Wird von einem Aufgabendialogfeld gesendet, wenn der Benutzer eine Schaltfläche oder einen Befehlslink im Aufgabendialogfeld auswählt. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.
TDN_CREATED	Wird von einem Aufgabendialogfeld gesendet, nachdem das Aufgabendialogfeld erstellt wurde und bevor es angezeigt wird. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.
TDN_DESTROYED	Wird von einem Aufgabendialogfeld gesendet, wenn es zerstört wird und sein Fensterhandle nicht mehr gültig ist. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.
TDN_DIALOG_CONSTRUCTED	Wird von einem Aufgabendialogfeld gesendet, nachdem das Aufgabendialogfeld erstellt wurde und bevor es angezeigt wird. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.
TDN_EXPANDO_BUTTON_CLICKED	Wird von einem Aufgabendialogfeld gesendet, wenn der Benutzer auf die Schaltfläche expando des Aufgabendialogfelds klickt. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.
TDN_HELP	Wird von einem Aufgabendialogfeld gesendet, wenn der Benutzer F1 auf der Tastatur drückt, während das Aufgabendialogfeld den Fokus hat. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.
TDN_HYPERLINK_CLICKED	Wird von einem Aufgabendialogfeld gesendet, wenn der Benutzer im Inhalt des Aufgabendialogfelds auf einen Link klickt. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.
TDN_NAVIGATED	Wird von einem Aufgabendialogfeld gesendet, wenn eine Navigation aufgetreten ist. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.
TDN_RADIO_BUTTON_CLICKED	Wird von einem Aufgabendialogfeld gesendet, wenn der Benutzer eine Schaltfläche oder einen Befehlslink im Aufgabendialogfeld auswählt. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.
TDN_TIMER	Wird ungefähr alle 200 Millisekunden von einem Aufgabendialog gesendet. Dieser Benachrichtigungscode wird gesendet, wenn das TDF_CALLBACK_TIMER-Flag im dwFlags-Element der TASKDIALOGCONFIG-Struktur festgelegt wurde, das an die TaskDialogIndirect-Funktion übergeben wurde. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.
TDN_VERIFICATION_CLICKED	Wird vom Aufgabendialogfeld gesendet, wenn der Benutzer auf das Kontrollkästchen Überprüfung des Aufgabendialogfelds klickt. Dieser Benachrichtigungscode wird nur über die Rückruffunktion des Aufgabendialogs empfangen, die mit der TaskDialogIndirect-Methode registriert werden kann.

Strukturen

Thema	Inhalte
TASKDIALOG_BUTTON	Enthält Informationen, die zum Anzeigen einer Schaltfläche in einem Aufgabendialogfeld verwendet werden. Die TASKDIALOGCONFIG-Struktur verwendet diese Struktur.
TASKDIALOGCONFIG	Enthält Informationen, die zum Anzeigen eines Aufgabendialogfelds verwendet werden. Die TaskDialogIndirect-Funktion verwendet diese Struktur.