Método IUIAnimationStoryboard2::Schedule (uianimation.h)

Artigo
08/26/2023

Direciona o storyboard para se agendar para jogar.

Sintaxe

HRESULT Schedule(
  [in]            UI_ANIMATION_SECONDS           timeNow,
  [out, optional] UI_ANIMATION_SCHEDULING_RESULT *schedulingResult
);

Parâmetros

[in] timeNow

A hora atual.

[out, optional] schedulingResult

O resultado da solicitação de agendamento. Você pode omitir esse parâmetro de chamadas para esse método.

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

Esse método direciona um storyboard para tentar se adicionar à agenda de reprodução de storyboards, usando estas regras:

Se não houver storyboards de reprodução animando qualquer uma das mesmas variáveis de animação, a tentativa será bem-sucedida e o storyboard começará a ser reproduzido imediatamente.
Se o storyboard tiver prioridade para cancelar, cortar, concluir ou compactar storyboards conflitantes, a tentativa de agendar terá êxito e o storyboard começará a ser reproduzido assim que possível.
Se o storyboard não tiver prioridade, a tentativa falhará e o parâmetro schedulingResult será definido como UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY.

Se esse método for chamado de um manipulador para eventos OnStoryboardStatusChanged , o parâmetro schedulingResult será definido como UI_ANIMATION_SCHEDULING_DEFERRED. A única maneira de determinar se o storyboard está agendado com êxito é definir um manipulador de eventos de storyboard e marcar se o status do storyboard se torna UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY.

É possível reutilizar um storyboard chamando Schedule novamente depois que seu status tiver atingido UI_ANIMATION_STORYBOARD_READY. Uma tentativa de agendar um storyboard quando ele estiver em qualquer estado diferente de UI_ANIMATION_STORYBOARD_BUILDING ou UI_ANIMATION_STORYBOARD_READY falhar e schedulingResult estiver definido como UI_ANIMATION_SCHEDULING_ALREADY_SCHEDULED.

Requisitos


Cliente mínimo com suporte	Windows 8, Windows 7 e Platform Update para Windows 7 [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