Share via

messaggio PSM_REMOVEPAGE

  • Articolo

Rimuove una pagina da una finestra delle proprietà. È possibile inviare questo messaggio in modo esplicito o usando la macro PropSheet_RemovePage .

Parametri

wParam

Indice in base zero della pagina da rimuovere.

lParam

Handle HPROPSHEETPAGE della pagina da rimuovere.

Valore restituito

Nessun valore restituito.

Commenti

Un'applicazione può specificare l'indice o l'handle o entrambi. Se entrambi sono specificati, lParam ha la precedenza.

L'invio di PSM_REMOVEPAGE elimina la pagina del foglio delle proprietà rimossa.

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 il messaggio PSM_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.

Requisiti

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