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

Define o manipulador de comparação de prioridade que determina se um storyboard agendado pode ser cancelado.

Sintaxe

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

Parâmetros

[in, optional] comparison

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

O objeto especificado deve implementar a interface IUIAnimationPriorityComparison2 ou ser NULL. Consulte Comentários para obter mais informações.

Valor retornado

Retorna S_OK se tiver êxito; caso contrário, 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 IUIAnimationManager2::Shutdown .

Requisitos

Confira também

IUIAnimationManager2

IUIAnimationManager2::SetCompressPriorityComparison

IUIAnimationManager2::SetConcludePriorityComparison

IUIAnimationManager2::SetTrimPriorityComparison

IUIAnimationPriorityComparison