macro PropSheet_RemovePage (prsht.h)

Articolo
10/24/2024

Rimuove una pagina da una finestra delle proprietà. È possibile utilizzare questa macro o inviare il messaggio di PSM_REMOVEPAGE in modo esplicito.

Sintassi

VOID PropSheet_RemovePage(
   HWND           hDlg,
   int            index,
   HPROPSHEETPAGE hpage
);

Parametri

hDlg

Tipo: HWND

Handle nella finestra delle proprietà.

index

Tipo: int

Indice in base zero della pagina da rimuovere.

hpage

Tipo: HPROPSHEETPAGE

Handle per la pagina da rimuovere.

Valore restituito

Tipo: VOID

Nessun valore restituito.

Osservazioni

Un'applicazione può specificare la pagina da rimuovere assegnando un valore a indice o hpage. Se i valori vengono assegnati sia a indice che a hpage, hpage ha la precedenza.

Un numero di messaggi e una chiamata di funzione si verificano mentre la finestra delle proprietà modifica l'elenco di pagine. Durante l'esecuzione di questa azione, il tentativo di modificare l'elenco di pagine avrà risultati imprevedibili. Di conseguenza, non è consigliabile utilizzare la macro PropSheet_RemovePage nell'implementazione di PropSheetPageProc o durante la gestione delle notifiche e dei messaggi di Windows seguenti.

Se è necessario modificare una pagina della finestra delle proprietà mentre si gestisce uno di questi messaggi o mentre PropSheetPageProc è in funzione, pubblicare manualmente un messaggio di Windows privato. L'applicazione non riceverà tale messaggio fino al termine delle attività da parte del gestore della finestra delle proprietà. È quindi possibile modificare l'elenco delle pagine.

Le notifiche seguenti sono interessate anche dalla modifica della finestra delle proprietà.

È possibile aggiungere o rimuovere pagine in risposta a queste notifiche, purché venga restituito (tramite DWL_MSGRESULT) un valore diverso da zero per specificare la nuova pagina desiderata. Si noti, tuttavia, che se si rimuove una pagina che si trova prima della pagina corrente (con un indice inferiore rispetto alla pagina corrente), PSN_KILLACTIVE potrebbe essere inviata alla pagina errata.

Nota Questa macro non è supportata quando si utilizza lo stile della procedura guidata Aero (PSH_AEROWIZARD).

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