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

Artículo
03/03/2024

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. Este parámetro se puede omitir de llamadas a este método.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de 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. Estas son las 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 jugar 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 guión gráfico y comprobar si el estado del guión gráfico se convierte en UI_ANIMATION_STORYBOARD_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 distinto de UI_ANIMATION_STORYBOARD_BUILDING o UI_ANIMATION_STORYBOARD_READY se produce un error y scheduleResult se establece en UI_ANIMATION_SCHEDULING_ALREADY_SCHEDULED.

Ejemplos

En el ejemplo siguiente se obtiene la hora actual y se programa el guión gráfico. Para obtener un ejemplo adicional, consulte Programación de un guión gráfico.

// Get the current time and schedule the storyboard
UI_ANIMATION_SECONDS secondsNow;
hr = m_pAnimationTimer->GetTime(
    &secondsNow
    );
if (SUCCEEDED(hr))
{
    UI_ANIMATION_SCHEDULING_RESULT schedulingResult;
    hr = pStoryboard->Schedule(
        secondsNow,
        &schedulingResult
        );
    if (SUCCEEDED(hr))
    {
        if (schedulingResult == UI_ANIMATION_SCHEDULING_SUCCEEDED)
        {
            ...
        }
        else
        {
            ...
        }
    }
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista y Actualización de plataforma para Windows Vista [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