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 PSM_CANCELTOCLOSE explícitamente.

Sintaxis

VOID PropSheet_CancelToClose(
   HWND hDlg
);

Parámetros

hDlg

Tipo: HWND

Identificador de la hoja de propiedades.

Valor devuelto

Tipo: VOID de

No hay ningún valor devuelto.

Observaciones

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

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 enfoque 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 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 están demasiado lejos para que las otras dos opciones sean prácticas.
Para la tercera opción, las aplicaciones deben enviar un mensaje 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 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