macro PropSheet_RemovePage (prsht.h)

Quita una página de una hoja de propiedades. Puede usar esta macro o enviar el mensaje PSM_REMOVEPAGE explícitamente.

Sintaxis

VOID PropSheet_RemovePage(
   HWND           hDlg,
   int            index,
   HPROPSHEETPAGE hpage
);

Parámetros

hDlg

Tipo: HWND

Identificador de la hoja de propiedades.

index

Tipo: int

Índice de base cero de la página que se va a quitar.

hpage

Tipo: HPROPSHEETPAGE

Identificador de la página que se va a quitar.

Valor devuelto

Tipo: VOID de

No hay ningún valor devuelto.

Observaciones

Una aplicación puede especificar la página que se va a quitar asignando un valor a índice o hpage. Si los valores se asignan a índice y hpage, hpage tiene prioridad.

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_RemovePage en la implementación de PropSheetPageProc o al controlar 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. Tenga en cuenta, sin embargo, que si quita 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