macro PropSheet_InsertPage (prsht.h)

Inserisce una nuova pagina in una finestra delle proprietà esistente. La pagina può essere inserita in corrispondenza di un indice specificato o dopo una pagina specificata. È possibile utilizzare questa macro o inviare il messaggio di PSM_INSERTPAGE in modo esplicito.

Sintassi

BOOL PropSheet_InsertPage(
   HWND hDlg,
   HWND index,
   HWND hpage
);

Parametri

hDlg

Tipo: HWND

Handle nella finestra delle proprietà.

index

Tipo: HWND

Posizione in cui inserire la pagina. Impostare index su NULL per rendere la nuova pagina la prima pagina. Per specificare dove deve essere inserita la nuova pagina, è possibile passare un indice o un handle HPROPSHEETPAGE di una pagina esistente.

Valore	Significato
indice	Se indice è minore di MAXUSHORT (l'intero corto senza segno più grande), specifica l'indice in base zero per la nuova pagina. Ad esempio, per rendere la terza pagina inserita nella finestra delle proprietà, impostare indice su 2. Per renderla la prima pagina, impostare indice su 0. Se indice ha un valore maggiore del numero di pagine e minore di MAXUSHORT, la pagina verrà aggiunta.
hpageInsertAfter	Se si imposta indice sull'handle HPROPSHEETPAGE di una pagina esistente, la nuova pagina verrà inserita dopo di essa.

hpage

Tipo: HWND

Handle per la pagina da inserire. La pagina deve essere prima creata da una chiamata alla funzione CreatePropertySheetPage.

Valore restituito

Tipo: BOOL

Restituisce un valore diverso da zero se la pagina è stata inserita correttamente oppure zero in caso contrario.

Osservazioni

Le pagine dopo il punto di inserimento vengono spostate a destra per contenere la nuova pagina.

La finestra delle proprietà non viene ridimensionata in base alla nuova pagina. Non ingrandire la nuova pagina rispetto alla pagina più grande della finestra delle proprietà.

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_InsertPage 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 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.

Le notifiche seguenti sono interessate anche dalla modifica della finestra delle proprietà.

• PSN_WIZBACK
• PSN_WIZNEXT

È 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 inserisce una pagina che si trova prima della pagina corrente (con un indice inferiore rispetto alla pagina corrente), PSN_KILLACTIVE potrebbe essere inviata alla pagina errata.

Nota Questa macro non è supportata quando si utilizza lo stile della procedura guidata Aero (PSH_AEROWIZARD).

 

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