Compartir a través de

macro PropSheet_AddPage (prsht.h)

  • Artículo

Agrega una nueva página al final de una hoja de propiedades existente. Puede usar esta macro o enviar explícitamente el mensaje de PSM_ADDPAGE .

Sintaxis

void PropSheet_AddPage(
   hDlg,
   hpage
);

Parámetros

hDlg

Tipo: HWND

Identificador de la hoja de propiedades.

hpage

Tipo: HPROPSHEETPAGE

Identificador de la página que se va a agregar. La página debe haber sido creada por una llamada anterior a la función CreatePropertySheetPage .

Valor devuelto

None

Observaciones

La nueva página no debe ser mayor que la página más grande que se encuentra actualmente en la hoja de propiedades porque la hoja de propiedades no se cambia de tamaño para ajustarse a la nueva página.

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 la macro PropSheet_AddPage en la implementación de PropSheetPageProc o mientras controla las siguientes notificaciones y mensajes de Microsoft 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.

Requisitos

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