macro PropSheet_AddPage (prsht.h)

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

Sintaxis

BOOL PropSheet_AddPage(
   HWND           hDlg,
   HPROPSHEETPAGE 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

Tipo: BOOL de

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

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 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_AddPage en la implementación de PropSheetPageProc o al controlar las siguientes notificaciones y mensajes de Microsoft 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.

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