Share via

macro PropSheet_CancelToClose (prsht.h)

  • Artigo

Usado quando as alterações feitas desde a notificação mais recente PSN_APPLY não podem ser canceladas. Você também pode enviar uma mensagem PSM_CANCELTOCLOSE explicitamente.

Sintaxe

void PropSheet_CancelToClose(
   hDlg
);

Parâmetros

hDlg

Tipo: HWND

Manipule para a folha de propriedades.

Retornar valor

Nenhum

Comentários

PSM_CANCELTOCLOSE desabilita o botão Cancelar e altera o texto do botão OK para "Fechar". Você pode usar essa macro ou enviar a mensagem PSM_CANCELTOCLOSE explicitamente.

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 aguarda 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 .
Nota Não há suporte para essa macro 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]
Plataforma de Destino Windows
Cabeçalho prsht.h