messaggio PSM_SETWIZBUTTONS

Abilita o disabilita i pulsanti Back, Next e Finish in una procedura guidata. È anche possibile usare la macro PropSheet_SetWizButtons per pubblicare il messaggio.

Parametri

wParam

Impostare questo parametro su PSWIZBF_ELEVATIONREQUIRED per visualizzare l'icona con privilegi elevati nei pulsanti specificati in lParam. L'icona con privilegi elevati (o icona dello schermo UAC) indica che verrà usata la richiesta di elevazione per richiedere all'utente l'approvazione o le credenziali. Per altre informazioni, vedere Progettazione di applicazioni UAC per Windows Vista.

Nota

La visualizzazione dell'icona dello schermo UAC è supportata solo in AeroWizards (PSH_AEROWIZARD).

lParam

Valore che specifica i pulsanti del foglio delle proprietà abilitati. È possibile combinare uno o più flag seguenti.

Valore	Significato
PSWIZB_BACK	Abilita il pulsante Indietro . Se questo flag non è impostato, il pulsante Indietro viene visualizzato come disabilitato.
PSWIZB_DISABLEDFINISH	Visualizza un pulsante Fine disabilitato.
PSWIZB_FINISH	Visualizza un pulsante Fine abilitato.
PSWIZB_NEXT	Abilita il pulsante Avanti. Se questo flag non è impostato, il pulsante Avanti viene visualizzato come disabilitato.

Valore restituito

Nessun valore restituito.

Commenti

Se il gestore di notifica usa PostMessage per inviare un messaggio di PSM_SETWIZBUTTONS , non influire sullo stato attivo della finestra fino a quando non viene restituito il gestore. Ad esempio, se si chiama MessageBox immediatamente dopo aver usato PostMessage per inviare PSM_SETWIZBUTTONS, la finestra di messaggio riceverà lo stato attivo. Poiché i messaggi pubblicati non vengono recapitati finché non raggiungono la testa della coda dei messaggi, il messaggio PSM_SETWIZBUTTONS non verrà recapitato fino a quando la procedura guidata non ha perso lo stato attivo nella finestra di messaggio. Di conseguenza, il foglio delle proprietà non sarà in grado di impostare correttamente lo stato attivo per i pulsanti.

Se si invia il messaggio di PSM_SETWIZBUTTONS durante la gestione della notifica PSN_SETACTIVE, usare la funzione PostMessage anziché la funzione SendMessage. In caso contrario, il sistema non aggiornerà correttamente i pulsanti. Se si usa la macro PropSheet_SetWizButtons per inviare questo messaggio, verrà pubblicata. In qualsiasi altro momento, è possibile usare SendMessage per inviare PSM_SETWIZBUTTONS.

Le procedure guidate visualizzano tre o quattro pulsanti sotto ogni pagina. Questo messaggio viene usato per specificare quali pulsanti sono abilitati. Le procedure guidate in genere visualizzano Indietro, Annulla e un pulsante Avanti o Fine . In genere si abilita solo il pulsante Avanti per la pagina iniziale, Avanti e Indietro per le pagine interne e Indietroe Fine per la pagina di completamento. Il pulsante Annulla è sempre abilitato. In genere, l'impostazione PSWIZB_FINISH o PSWIZB_DISABLEDFINISH sostituisce il pulsante Avanti con un pulsante Fine . Per visualizzare i pulsanti Avanti e Fine contemporaneamente, impostare il flag di PSH_WIZARDHASFINISH nel membro dwFlags della struttura PROPSHEETHEADER della procedura guidata quando si crea la procedura guidata. Ogni pagina visualizzerà quindi tutti e quattro i pulsanti.

Requisiti

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