Condividi tramite


PSM_INSERTPAGE messaggio

Inserisce una nuova pagina in un foglio delle proprietà esistente. La pagina può essere inserita in corrispondenza di un indice specificato o dopo una pagina specificata. È possibile inviare questo messaggio in modo esplicito o usando la macro PropSheet_InsertPage .

Parametri

wParam

Dove inserire la pagina. Impostare questo parametro 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
index
Se il parametro wParam è minore di MAXUSHORT (numero intero corto senza segno più grande), wParam specifica l'indice in base zero per la nuova pagina. Ad esempio, per rendere la terza pagina inserita nella scheda delle proprietà, impostare wParam su 2. Per renderla la prima pagina, impostare wParam su 0. Se wParam ha un valore maggiore del numero di pagine e minore di MAXUSHORT, verrà aggiunta la pagina.
hpageInsertAfter
Se si imposta il parametro wParam sull'handle HPROPSHEETPAGE di una pagina esistente, la nuova pagina verrà inserita dopo di essa.

lParam

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

Valore restituito

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

Commenti

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

Il foglio delle proprietà non viene ridimensionato per adattarsi alla nuova pagina. Non rendere la nuova pagina più grande della pagina più grande del foglio delle proprietà.

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

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.

Le notifiche seguenti sono interessate anche dalla modifica del foglio delle proprietà.

È 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 più piccolo rispetto alla pagina corrente), PSN_KILLACTIVE potrebbe essere inviata alla pagina errata.

Nota

Questo messaggio non è supportato quando si usa 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]
Intestazione
Prsht.h