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

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

Sintaxe

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

Parâmetros

[in, optional] comparison

O manipulador de comparação de prioridade para conclusão. O objeto especificado deve implementar a interface IUIAnimationPriorityComparison2 ou ser NULL. Consulte Comentários para obter mais informações.

Retornar valor

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 concluindo o storyboard agendado.

Um storyboard agendado só poderá ser concluído se contiver um loop com uma contagem de repetição de UI_ANIMATION_REPEAT_INDEFINITELY e o objeto de comparação de prioridade registrado com esse método retornar S_OK. Se o storyboard for concluído, a repetição atual do loop será concluída e o restante do storyboard será reproduzido.

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 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::SetCancelPriorityComparison

IUIAnimationManager2::SetCompressPriorityComparison

IUIAnimationManager2::SetTrimPriorityComparison

IUIAnimationPriorityComparison