Condividi tramite

macro PropSheet_RemovePage (prsht.h)

  • Articolo

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

Sintassi

void PropSheet_RemovePage(
   hDlg,
   index,
   hpage
);

Parametri

hDlg

Tipo: HWND

Handle nel foglio delle proprietà.

index

Tipo: int

Indice in base zero della pagina da rimuovere.

hpage

Tipo: HPROPSHEETPAGE

Gestire la pagina da rimuovere.

Valore restituito

nessuno

Osservazioni

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

Un numero di messaggi e una chiamata di funzione si verificano mentre il foglio 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 usare 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 del foglio delle proprietà durante la gestione di uno di questi messaggi o mentre PropSheetPageProc è in esecuzione, pubblicare un messaggio di Windows privato. L'applicazione non riceverà tale messaggio fino al termine delle attività da parte del gestore foglio di proprietà. È quindi possibile modificare l'elenco di pagine.

Le notifiche seguenti sono interessate anche dalla modifica del foglio 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 più piccolo rispetto alla pagina corrente), PSN_KILLACTIVE potrebbe essere inviata alla pagina errata.
Nota Questa macro non è supportata quando si usa lo stile della procedura guidata Aero (PSH_AEROWIZARD).
 

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione prsht.h