messaggio PSM_ADDPAGE

Aggiunge una nuova pagina alla fine di un foglio delle proprietà esistente. È possibile inviare questo messaggio in modo esplicito o usando la macro PropSheet_AddPage .

Parametri

wParam

Deve essere zero.

lParam

Gestire la pagina da aggiungere. La pagina deve essere stata creata da una chiamata precedente alla funzione CreatePropertySheetPage .

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario.

Commenti

La nuova pagina non deve essere più grande della pagina più grande attualmente presente nel foglio delle proprietà perché il foglio delle proprietà non viene ridimensionato in modo da adattare la nuova pagina.

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 di PSM_ADDPAGE nell'implementazione di PropSheetPageProc o durante la gestione delle notifiche e dei messaggi di Windows seguenti.

• PSN_APPLY
• PSN_KILLACTIVE
• PSN_RESET
• PSN_SETACTIVE
• WM_DESTROY
• WM_INITDIALOG

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.

Requisiti

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