Compartir a través de

macro PropSheet_InsertPage (prsht.h)

  • Artículo

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 usar esta macro o enviar el mensaje PSM_INSERTPAGE explícitamente.

Sintaxis

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

Parámetros

hDlg

Tipo: HWND

Identificador de la hoja de propiedades.

index

Tipo: HWND

Donde se va a insertar la página. Establezca índice en NULL para que la página nueva sea 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
de índice
 Si índice es menor que MAXUSHORT (el entero corto sin signo más grande), especifica el índice de base cero para la nueva página. Por ejemplo, para que la página insertada sea la tercera página de la hoja de propiedades, establezca índice en 2. Para que sea la primera página, establezca índice en 0. Si índice tiene un valor mayor que el número de páginas y menor que MAXUSHORT, se anexará la página.
hpageInsertAfter
 Si establece índice en el identificador HPROPSHEETPAGE de una página existente, la nueva página se insertará después de ella.

hpage

Tipo: HWND

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

Tipo: BOOL de

Devuelve un valor distinto de cero si la página se ha insertado correctamente o cero de lo contrario.

Observaciones

Las páginas después del punto de inserción se desplazan a la derecha para acomodar 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 página nueva sea mayor que la página más grande de la hoja de propiedades.

Se produce una serie de mensajes y una llamada de función mientras la hoja de propiedades manipula la lista de páginas. Mientras se realiza esta acción, si se intenta modificar la lista de páginas, habrá resultados impredecibles. Por lo tanto, no debe usar la macro PropSheet_InsertPage en la implementación de PropSheetPageProc o al controlar las siguientes notificaciones y mensajes de Windows.

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.

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. Tenga en cuenta, sin embargo, 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 se envíe PSN_KILLACTIVE a la página incorrecta.
Nota Esta macro no se admite al usar el estilo del asistente Aero (PSH_AEROWIZARD).
 

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de prsht.h