macro PropSheet_SetWizButtons (prsht.h)

Articolo
10/24/2024

Abilita o disabilita i pulsanti Indietro, Avanti e Fine in una procedura guidata pubblicando un messaggio di PSM_SETWIZBUTTONS. È possibile utilizzare questa macro o inviare il messaggio di PSM_SETWIZBUTTONS in modo esplicito.

Sintassi

VOID PropSheet_SetWizButtons(
   HWND  hDlg,
   DWORD dwFlags
);

Parametri

hDlg

Tipo: HWND

Handle nella finestra delle proprietà.

dwFlags

Tipo: DWORD

Valore che specifica quali pulsanti della procedura guidata sono abilitati. È possibile combinare uno o più flag seguenti.

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

Valore restituito

Tipo: VOID

Nessun valore restituito.

Osservazioni

Questa macro usa PostMessage per inviare il messaggio di PSM_SETWIZBUTTONS. Se il gestore delle notifiche chiama PropSheet_SetWizButtons, non eseguire alcuna operazione che influirà sullo stato attivo della finestra fino a quando il gestore non viene restituito. Ad esempio, se si chiama MessageBox immediatamente dopo aver chiamato PropSheet_SetWizButtons, la finestra di messaggio riceverà lo stato attivo. Poiché i messaggi inviati con PostMessage non vengono recapitati fino a quando non raggiungono l'inizio della coda di messaggi, il messaggio PSM_SETWIZBUTTONS non verrà recapitato fino a quando la procedura guidata non ha perso lo stato attivo per la finestra di messaggio. Di conseguenza, la finestra delle proprietà non sarà in grado di impostare correttamente lo stato attivo per i pulsanti.

Le procedure guidate visualizzano tre o quattro pulsanti sotto ogni pagina. Questo messaggio viene usato per specificare quali pulsanti sono abilitati. Le procedure guidate visualizzano in genere 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 Indietro per la pagina di completamento. Il pulsante Annulla è sempre abilitato. In genere, l'impostazione di PSWIZB_FINISH o PSWIZB_DISABLEDFINISH sostituisce il pulsante Avanti con un pulsante Fine. Per visualizzare contemporaneamente i pulsanti Avanti e Fine, impostare la PSH_WIZARDHASFINISH FLAG nella dwFlags membro della struttura PROPSHEETHEADER della procedura guidata quando si crea la procedura guidata. Ogni pagina visualizzerà quindi tutti e quattro i pulsanti.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	prsht.h

Condividi tramite