PSM_REMOVEPAGE mensaje

Quita una página de una hoja de propiedades. Puede enviar este mensaje explícitamente o mediante la macro PropSheet_RemovePage .

Parámetros

wParam

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

lParam

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

Valor devuelto

No de devuelve ningún valor.

Comentarios

Una aplicación puede especificar el índice o el identificador, o ambos. Si se especifican ambos, lParam tiene prioridad.

El envío de PSM_REMOVEPAGE destruye la página de hoja de propiedades que se va a quitar.

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_REMOVEPAGE 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 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 PSN_KILLACTIVE se envíen a la página incorrecta.

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