Compartir a través de

macro PropSheet_CancelToClose (prsht.h)

  • Artículo

Se usa cuando no se pueden cancelar los cambios realizados desde la notificación de PSN_APPLY más reciente. También puede enviar un mensaje de PSM_CANCELTOCLOSE explícitamente.

Sintaxis

void PropSheet_CancelToClose(
   hDlg
);

Parámetros

hDlg

Tipo: HWND

Identificador de la hoja de propiedades.

Valor devuelto

None

Observaciones

PSM_CANCELTOCLOSE deshabilita el botón Cancelar y cambia el texto del botón Aceptar a "Cerrar". Puede usar esta macro o enviar el mensaje PSM_CANCELTOCLOSE explícitamente.

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 de 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. Esa 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 Esta macro 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]
Plataforma de destino Windows
Encabezado prsht.h