PropSheet_CancelToClose macro (prsht.h)

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

Sintaxe

VOID PropSheet_CancelToClose(
   HWND hDlg
);

Parâmetros

hDlg

Tipo: HWND

Manipule para a folha de propriedades.

Valor de retorno

Tipo: void

Nenhum valor retornado.

Observações

PSM_CANCELTOCLOSE desabilita o botão Cancelar e altera o texto do botão OK do 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 PSN_APPLY seja recebida. No entanto, em algumas circunstâncias, uma folha de propriedades pode fazer alterações irreversíveis fora da sequência dePSN_RESET/PSN_APPLY padrão. Um exemplo é uma folha de propriedades que contém um botão Editar que é usado para exibir uma caixa de subdialogação para editar uma propriedade. Quando o usuário clica 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 aguardar 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 subdialogação, mas lembre-se das configurações originais. Essas configurações poderão ser usadas para restaurar o estado original se uma notificação 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 de PSM_CANCELTOCLOSE para a folha de propriedades. Indica ao usuário que as alterações feitas com a caixa de subdialoga não podem ser revertidas clicando no botão Cancelar.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	prsht.h