PFTASKDIALOGCALLBACK-Rückruffunktion (commctrl.h)

Artikel
08/22/2023

Die TaskDialogCallbackProc-Funktion ist eine anwendungsdefinierte Funktion, die mit der TaskDialogIndirect-Funktion verwendet wird. Es empfängt Meldungen 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.

Syntax

PFTASKDIALOGCALLBACK Pftaskdialogcallback;

HRESULT Pftaskdialogcallback(
  [in] HWND hwnd,
  [in] UINT msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam,
       LONG_PTR lpRefData
)
{...}

Parameter

[in] hwnd

Typ: HWND

Handle mit dem Fenster TaskDialog. Setzen Sie das Senden von Nachrichten an hwnd nicht fort, nachdem die Rückrufprozedur mit TDN_DESTROYED aufgerufen wurde.

[in] msg

Typ: UINT

Eine der folgenden Benachrichtigungen.

Benachrichtigung	Verbrauch
TDN_BUTTON_CLICKED	Gibt an, dass eine Schaltfläche ausgewählt wurde. Die Befehls-ID der Schaltfläche wird von wParam angegeben.
TDN_CREATED	Gibt an, dass das Aufgabendialogfeld erstellt wurde.
TDN_DESTROYED	Gibt an, dass das Aufgabendialogfeld zerstört wurde.
TDN_DIALOG_CONSTRUCTED	Gibt an, dass das Aufgabendialogfeld erstellt, aber noch nicht angezeigt wurde.
TDN_EXPANDO_BUTTON_CLICKED	Gibt an, dass die Schaltfläche expando ausgewählt wurde.
TDN_HELP	Gibt an, dass die F1-Taste gedrückt wurde, während das Aufgabendialogfeld den Fokus hat.
TDN_HYPERLINK_CLICKED	Gibt an, dass ein Link ausgewählt wurde. Ein Zeiger auf den Linktext wird von lParam angegeben.
TDN_NAVIGATED	Gibt an, dass die Navigation erfolgt ist.
TDN_RADIO_BUTTON_CLICKED	Gibt an, dass ein Optionsfeld ausgewählt wurde. Die Befehls-ID des Optionsfelds wird von wParam angegeben.
TDN_TIMER	Gibt an, dass der Taskdialogzeitgeber ausgelöst wurde. Die gesamt verstrichene Zeit wird von wParam angegeben. Sie können die Statusanzeige aktualisieren, indem Sie eine TDM_SET_PROGRESS_BAR_POS Meldung an das fenster senden, das durch den hwnd-Parameter angegeben wird.
TDN_VERIFICATION_CLICKED	Gibt an, dass das Kontrollkästchen Aufgabendialogfeld überprüfung aktiviert wurde.

[in] wParam

Typ: WPARAM

Gibt zusätzliche Benachrichtigungsinformationen an. Der Inhalt dieses Parameters hängt vom Wert des uNotification-Parameters ab.

[in] lParam

Typ: LPARAM

Gibt zusätzliche Benachrichtigungsinformationen an. Der Inhalt dieses Parameters hängt vom Wert des uNotification-Parameters ab.

lpRefData

Typ: LONG_PTR

Zeiger auf anwendungsspezifische Daten. Dies sind die Daten, auf die der lpCallbackData-Member der Struktur TASKDIALOGCONFIG verweist, der zum Erstellen des Aufgabendialogfelds verwendet wird.

Rückgabewert

Typ: HRESULT

Der Rückgabewert ist spezifisch für die verarbeitete Benachrichtigung. Wenn Sie auf einen Schaltflächenklick reagieren, sollte Ihre Implementierung S_FALSE zurückgeben, wenn das Aufgabendialogfeld nicht geschlossen werden soll. Andernfalls wird S_OK zurückgegeben.

Hinweise

Eine Anwendung muss diese Rückruffunktion registrieren, indem sie ihre Adresse im pfCallback-Member der TASKDIALOGCONFIG-Struktur übergibt, die über den Zeiger über TaskDialogIndirect übergeben wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h (include Commctrl.h)

Freigeben über