Compartilhar via


Método IUIAnimationManager::SetCancelPriorityComparison (uianimation.h)

Define o manipulador de comparação de prioridade a ser chamado para determinar se um storyboard agendado pode ser cancelado.

Sintaxe

HRESULT SetCancelPriorityComparison(
  [in, optional] IUIAnimationPriorityComparison *comparison
);

Parâmetros

[in, optional] comparison

O manipulador de comparação de prioridade para cancelamento.

O objeto especificado deve implementar a interface IUIAnimationPriorityComparison ou ser NULL.

Consulte Observações.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Consulte Códigos de erro de animação do Windows para obter uma lista de códigos de erro.

Comentários

Definir um manipulador de comparação de prioridade com esse método permite que o aplicativo indique quando conflitos de agendamento podem ser resolvidos cancelando storyboards.

Um storyboard agendado só poderá ser cancelado se ele não tiver começado a ser reproduzido e o objeto de comparação de prioridade registrado com esse método retornar S_OK. Os storyboards cancelados são completamente removidos do agendamento.

Passar NULL para o parâmetro de comparação faz com que a Animação do Windows libere sua referência a qualquer objeto de manipulador de comparação de prioridade que você passou anteriormente. Essa técnica pode ser essencial para quebrar ciclos de referência sem precisar chamar o método IUIAnimationManager::Shutdown .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho uianimation.h
DLL UIAnimation.dll

Confira também

IUIAnimationManager

IUIAnimationManager::SetCompressPriorityComparison

IUIAnimationManager::SetConcludePriorityComparison

IUIAnimationManager::SetTrimPriorityComparison

IUIAnimationPriorityComparison