mensaje de PSM_INSERTPAGE

Inserta una nueva página en una hoja de propiedades existente. La página se puede insertar en un índice especificado o después de una página especificada. Puede enviar este mensaje explícitamente o mediante la macro PropSheet_InsertPage .

Parámetros

wParam

Donde se va a insertar la página. Establezca este parámetro en NULL para convertir la nueva página en la primera página. Para especificar dónde se va a insertar la nueva página, puede pasar un índice o un identificador HPROPSHEETPAGE de una página existente.

Valor	Significado
índice	Si el parámetro wParam es menor que MAXUSHORT (el entero corto sin signo más grande), wParam especifica el índice de base cero para la nueva página. Por ejemplo, para convertir la página insertada en la tercera página de la hoja de propiedades, establezca wParam en 2. Para convertirlo en la primera página, establezca wParam en 0. Si wParam tiene un valor mayor que el número de páginas y menor que MAXUSHORT, se anexará la página.
hpageInsertAfter	Si establece el parámetro wParam en el identificador HPROPSHEETPAGE de una página existente, la nueva página se insertará después de ella.

lParam

Identificador de la página que se va a insertar. La página debe crearse primero mediante una llamada a la función CreatePropertySheetPage .

Valor devuelto

Devuelve un valor distinto de cero si la página se insertó correctamente o cero en caso contrario.

Observaciones

Las páginas después del punto de inserción se desplazan a la derecha para dar cabida a la nueva página.

No se cambia el tamaño de la hoja de propiedades para ajustarse a la nueva página. No haga que la nueva página sea mayor que la página más grande de la hoja de propiedades.

Se producen varios mensajes y una llamada de función mientras la hoja de propiedades manipula la lista de páginas. Mientras se realiza esta acción, el intento de modificar la lista de páginas tendrá resultados imprevisibles. En consecuencia, no debe usar el mensaje de PSM_INSERTPAGE en la implementación de PropSheetPageProc o mientras controla las siguientes notificaciones y mensajes de Windows.

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

Si necesita modificar una página de hoja de propiedades mientras controla uno de estos mensajes o mientras PropSheetPageProc está en funcionamiento, publique un mensaje privado de Windows. La aplicación no recibirá ese mensaje hasta que el administrador de hojas de propiedades haya terminado sus tareas. A continuación, puede modificar la lista de páginas.

Las siguientes notificaciones también se ven afectadas por la modificación de la hoja de propiedades.

• PSN_WIZBACK
• PSN_WIZNEXT

Puede agregar o quitar páginas en respuesta a estas notificaciones, siempre que devuelva (a través de DWL_MSGRESULT) un valor distinto de cero para especificar la nueva página deseada. Sin embargo, tenga en cuenta que si inserta una página que se encuentra antes de la página actual (que tiene un índice menor que la página actual), es posible que PSN_KILLACTIVE se envíen a la página incorrecta.

Nota

Este mensaje no se admite cuando se usa el estilo del asistente Aero (PSH_AEROWIZARD).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Prsht.h