Compartilhar via


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

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

Sintaxe

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

Parâmetros

[in, optional] comparison

O manipulador de comparação de prioridade para conclusão. 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 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 lembrete 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 passado 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::SetCancelPriorityComparison

IUIAnimationManager::SetCompressPriorityComparison

IUIAnimationManager::SetTrimPriorityComparison

IUIAnimationPriorityComparison