Condividi tramite

messaggio di TDM_NAVIGATE_PAGE

  • Articolo

Ricrea una finestra di dialogo attività con nuovi contenuti, simulando la funzionalità di una procedura guidata a più pagine.

Parametri

wParam [in]

Non usato. Deve essere zero.

lParam [in]

Puntatore a una struttura TASKDIALOGCONFIG che descrive la finestra di dialogo attività da creare. L'applicazione chiamante deve allocare questa struttura e impostare i relativi membri. I valori dei membri variano a seconda del tipo di pagina a cui l'utente passa.

Valore restituito

Il valore restituito viene ignorato.

Commenti

Per avviare una finestra di dialogo attività della procedura guidata, usare la funzione TaskDialogIndirect . Quando l'utente passa tramite la procedura guidata, inviare questo messaggio alla finestra di dialogo attività per visualizzare la pagina successiva. Viene creata una nuova finestra di dialogo attività (simile a una nuova pagina) con gli elementi specificati nella struttura a cui punta lParam. Al momento della creazione, l'intero contenuto della cornice del dialogo viene distrutto e ricostruito. Di conseguenza, tutte le informazioni sullo stato contenute dai controlli (ad esempio, un indicatore di stato, un pulsante expando o una casella di controllo di verifica) nella finestra di dialogo vengono perse.

Il layout della finestra di dialogo attività potrebbe non riuscire e questo potrebbe non essere riflesso nel valore restituito. Un valore restituito di S_OK riflette solo che la finestra di dialogo attività ha ricevuto il messaggio e ha tentato di elaborarla. Se il layout della finestra di dialogo attività ha esito negativo (non è possibile visualizzare la finestra di dialogo attività), la finestra di dialogo verrà chiusa e verrà restituito un codice HRESULT nella funzione di callback registrata. Per altre informazioni sulla sintassi della funzione di callback, vedere TaskDialogCallbackProc.

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista [solo app desktop]
Server minimo supportato
 Windows Server 2008 [solo app desktop]
Intestazione
Commctrl.h