Compartilhar via

PSM_CANCELTOCLOSE mensagem

  • Artigo

Enviado por um aplicativo quando ele executa alterações desde a notificação mais recente PSN_APPLY que não pode ser cancelada. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_CancelToClose .

Parâmetros

wParam

Deve ser zero.

lParam

Deve ser zero.

Valor retornado

Sem valor de retorno.

Comentários

PSM_CANCELTOCLOSE desabilita o botão Cancelar e altera o texto do botão OK para "Fechar".

A maioria das folhas de propriedades aguarda para executar alterações irreversíveis até que uma notificação de PSN_APPLY seja recebida. No entanto, em algumas circunstâncias, uma folha de propriedades pode fazer alterações irreversíveis fora da sequência de PSN_APPLY/PSN_RESET padrão. Um exemplo é uma folha de propriedades que contém um botão Editar que é usado para exibir uma caixa de subdialoga para editar uma propriedade. Quando o usuário clica em OK para enviar a alteração, a página da folha de propriedades tem várias opções.

  • Ele pode registrar as alterações, mas aguarde até receber uma notificação PSN_APPLY para aplicá-las. Essa é a abordagem preferencial.
  • Ele pode aplicar as alterações imediatamente após sair da caixa de subdialog, mas lembre-se das configurações originais. Essas configurações podem ser usadas para restaurar o estado original se uma notificação de PSN_RESET for recebida.
  • Ele pode aplicar as alterações imediatamente e não tentar restaurar as configurações originais quando recebe uma notificação de PSN_RESET . Essa abordagem não é recomendada, mas pode ser necessária se as alterações forem muito abrangentes para que as outras duas opções sejam práticas.

Para a terceira opção, os aplicativos devem enviar uma mensagem PSM_CANCELTOCLOSE para a folha de propriedades. Indica ao usuário que as alterações feitas com a caixa de subdialog não podem ser revertidas clicando no botão Cancelar .

Observação

Não há suporte para essa mensagem ao usar o estilo do assistente aero (PSH_AEROWIZARD).

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Prsht.h