Compartir a través de

mensaje de PSM_CANCELTOCLOSE

  • Artículo

Enviado por una aplicación cuando ha realizado cambios desde la notificación de PSN_APPLY más reciente que no se puede cancelar. Puede enviar este mensaje explícitamente o mediante la macro PropSheet_CancelToClose .

Parámetros

wParam

Debe ser cero.

lParam

Debe ser cero.

Valor devuelto

No de devuelve ningún valor.

Comentarios

PSM_CANCELTOCLOSE deshabilita el botón Cancelar y cambia el texto del botón Aceptar a "Cerrar".

La mayoría de las hojas de propiedades esperan a realizar cambios irreversibles hasta que se recibe una notificación de PSN_APPLY. Sin embargo, en algunas circunstancias, una hoja de propiedades puede realizar cambios irreversibles fuera de la secuencia estándar PSN_APPLY/PSN_RESET. Un ejemplo es una hoja de propiedades que contiene un botón Editar que se usa para mostrar un cuadro de subdialog para editar una propiedad. Cuando el usuario hace clic en Aceptar para enviar el cambio, la página de la hoja de propiedades tiene varias opciones.

  • Puede registrar los cambios, pero esperar hasta que reciba una notificación PSN_APPLY para aplicarlos. Este es el método preferido.
  • Puede aplicar los cambios inmediatamente después de salir del cuadro de subdialog, pero recuerde la configuración original. Esta configuración se puede usar para restaurar el estado original si se recibe una notificación de PSN_RESET.
  • Puede aplicar los cambios inmediatamente y no intentar restaurar la configuración original cuando recibe una notificación de PSN_RESET . Este enfoque no se recomienda, pero puede ser necesario si los cambios son demasiado lejanos para que las otras dos opciones sean prácticas.

Para la tercera opción, las aplicaciones deben enviar un mensaje de PSM_CANCELTOCLOSE a la hoja de propiedades. Indica al usuario que los cambios realizados con el cuadro de subdialog no se pueden invertir haciendo clic en el botón Cancelar .

Nota

Este mensaje no se admite cuando se usa el estilo del asistente Aero (PSH_AEROWIZARD).

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