macro PropSheet_AddPage (prsht.h)

Aggiunge una nuova pagina alla fine di una finestra delle proprietà esistente. È possibile utilizzare questa macro o inviare il messaggio di PSM_ADDPAGE in modo esplicito.

Sintassi

BOOL PropSheet_AddPage(
   HWND           hDlg,
   HPROPSHEETPAGE hpage
);

Parametri

hDlg

Tipo: HWND

Handle nella finestra delle proprietà.

hpage

Tipo: HPROPSHEETPAGE

Handle nella pagina da aggiungere. La pagina deve essere stata creata da una chiamata precedente alla funzione CreatePropertySheetPage.

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

La nuova pagina non deve essere più grande della pagina più grande attualmente presente nella finestra delle proprietà perché la finestra delle proprietà non viene ridimensionata in base alla nuova pagina.

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

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

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.

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