macro PropSheet_CancelToClose (prsht.h)
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.
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 |