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

Artículo
08/26/2023

Dirige el guión gráfico para programarse para jugar.

Sintaxis

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

Parámetros

[in] timeNow

La hora actual.

[out, optional] schedulingResult

Resultado de la solicitud de programación. Puede omitir este parámetro de las llamadas a este método.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente; de lo contrario, un código de error HRESULT . Consulta Códigos de error de animación de Windows para obtener una lista de códigos de error.

Comentarios

Este método dirige un guión gráfico para intentar agregarse a la programación de reproducir guiones gráficos, con estas reglas:

Si no hay guiones gráficos de reproducción que animan cualquiera de las mismas variables de animación, el intento se realiza correctamente y el guión gráfico comienza a reproducirse inmediatamente.
Si el guión gráfico tiene prioridad para cancelar, recortar, concluir o comprimir guiones gráficos en conflicto, el intento de programar se realiza correctamente y el guión gráfico comienza a reproducirse lo antes posible.
Si el guión gráfico no tiene prioridad, se produce un error en el intento y el parámetro schedulingResult se establece en UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY.

Si se llama a este método desde un controlador para eventos OnStoryboardStatusChanged , el parámetro schedulingResult se establece en UI_ANIMATION_SCHEDULING_DEFERRED. La única manera de determinar si el guión gráfico está programado correctamente es establecer un controlador de eventos de guion gráfico y comprobar si el estado del guión gráfico se convierte en UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY.

Es posible volver a usar un guión gráfico llamando a Schedule de nuevo después de que su estado haya alcanzado UI_ANIMATION_STORYBOARD_READY. Se intenta programar un guión gráfico cuando se encuentra en cualquier estado que no sea UI_ANIMATION_STORYBOARD_BUILDING o UI_ANIMATION_STORYBOARD_READY se produce un error y schedulingResult se establece en UI_ANIMATION_SCHEDULING_ALREADY_SCHEDULED.

Requisitos


Cliente mínimo compatible	Windows 8, Windows 7 y Platform Update para Windows 7 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	uianimation.h
Archivo DLL	UIAnimation.dll