Condividi tramite

macro PropSheet_InsertPage (prsht.h)

  • Articolo

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

void PropSheet_InsertPage(
   hDlg,
   index,
   hpage
);

Parametri

hDlg

Tipo: HWND

Handle nella finestra delle proprietà.

index

Tipo: HWND

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

Valore Significato
index
 Se wParam è minore di MAXUSHORT (l'intero breve senza segno più grande), specifica l'indice in base zero per la nuova pagina. Ad esempio, per rendere la pagina inserita la terza pagina nella finestra delle proprietà, impostare index su 2. Per renderla la prima pagina, impostare index su 0. Se index ha un valore maggiore del numero di pagine e minore di MAXUSHORT, la pagina verrà aggiunta.
hpageInsertAfter
 Se si imposta wParam 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 prima essere creata da una chiamata alla funzione CreatePropertySheetPage .

Valore restituito

nessuno

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

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

È possibile aggiungere o rimuovere pagine in risposta a queste notifiche, purché tu restituisca (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 più piccolo della 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).
 

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