Condividi tramite

macro PropSheet_AddPage (prsht.h)

  • Articolo

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

void PropSheet_AddPage(
   hDlg,
   hpage
);

Parametri

hDlg

Tipo: HWND

Handle nella finestra delle proprietà.

hpage

Tipo: HPROPSHEETPAGE

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

Valore restituito

nessuno

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 per adattarsi alla nuova pagina.

Un numero di messaggi e una chiamata di funzione vengono eseguiti 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:

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 delle finestre delle 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]
Piattaforma di destinazione Windows
Intestazione prsht.h