Funzione di callback PFTASKDIALOGCALLBACK (commctrl.h)

Articolo
02/26/2024

La funzione TaskDialogCallbackProc è una funzione definita dall'applicazione usata con la funzione TaskDialogIndirect . Riceve messaggi dalla finestra di dialogo attività quando si verificano vari eventi.

Il tipo PFTASKDIALOGCALLBACK definisce un puntatore a questa funzione di callback. TaskDialogCallbackProc è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PFTASKDIALOGCALLBACK Pftaskdialogcallback;

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

Parametri

[in] hwnd

Tipo: HWND

Gestire nella finestra TaskDialog. Non continuare a inviare messaggi a hwnd dopo la restituzione della routine di callback da quando è stata chiamata con TDN_DESTROYED.

[in] msg

Tipo: UINT

Una delle notifiche seguenti.

Notifica	Utilizzo
TDN_BUTTON_CLICKED	Indica che è stato selezionato un pulsante. L'ID comando del pulsante viene specificato da wParam.
TDN_CREATED	Indica che la finestra di dialogo attività è stata creata.
TDN_DESTROYED	Indica che la finestra di dialogo attività è stata eliminata definitivamente.
TDN_DIALOG_CONSTRUCTED	Indica che la finestra di dialogo attività è stata creata ma non è ancora stata visualizzata.
TDN_EXPANDO_BUTTON_CLICKED	Indica che il pulsante expando è stato selezionato.
TDN_HELP	Indica che il tasto F1 è stato premuto mentre la finestra di dialogo attività ha lo stato attivo.
TDN_HYPERLINK_CLICKED	Indica che è stato selezionato un collegamento ipertestuale. Un puntatore al testo del collegamento viene specificato da lParam.
TDN_NAVIGATED	Indica che si è verificato lo spostamento.
TDN_RADIO_BUTTON_CLICKED	Indica che è stato selezionato un pulsante di opzione. L'ID comando del pulsante di opzione viene specificato da wParam.
TDN_TIMER	Indica che il timer della finestra di dialogo attività è stato attivato. Il tempo trascorso totale viene specificato da wParam. È possibile aggiornare l'indicatore di stato inviando un messaggio TDM_SET_PROGRESS_BAR_POS alla finestra specificata dal parametro hwnd .
TDN_VERIFICATION_CLICKED	Indica che la casella di controllo Verifica finestra di dialogo attività è stata selezionata.

[in] wParam

Tipo: WPARAM

Specifica informazioni aggiuntive sulla notifica. Il contenuto di questo parametro dipende dal valore del parametro uNotification .

[in] lParam

Tipo: LPARAM

Specifica informazioni aggiuntive sulla notifica. Il contenuto di questo parametro dipende dal valore del parametro uNotification .

lpRefData

Tipo: LONG_PTR

Puntatore a dati specifici dell'applicazione. Si tratta dei dati a cui punta il membro lpCallbackData della struttura TASKDIALOGCONFIG usato per creare la finestra di dialogo attività.

Valore restituito

Tipo: HRESULT

Il valore restituito è specifico della notifica in fase di elaborazione. Quando si risponde a un clic su un pulsante, l'implementazione deve restituire S_FALSE se la finestra di dialogo attività non è da chiudere. In caso contrario, restituire S_OK.

Commenti

Un'applicazione deve registrare questa funzione di callback passandone l'indirizzo nel membro pfCallback della struttura TASKDIALOGCONFIG passata tramite puntatore a TaskDialogIndirect.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h (include Commctrl.h)

Condividi tramite