IUIAnimationStoryboard2::Schedule-Methode (uianimation.h)

Artikel
08/26/2023

Weist das Storyboard an, sich selbst für die Wiedergabe zu planen.

Syntax

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

Parameter

[in] timeNow

Die aktuelle Zeit.

[out, optional] schedulingResult

Das Ergebnis der Terminplanungsanforderung. Sie können diesen Parameter von Aufrufen dieser Methode weglassen.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. andernfalls ein HRESULT-Fehlercode . Eine Liste der Fehlercodes finden Sie unter Fehlercodes für die Windows-Animation .

Hinweise

Diese Methode weist ein Storyboard an, sich mithilfe der folgenden Regeln dem Zeitplan für die Wiedergabe von Storyboards hinzuzufügen:

Wenn keine Storyboards zur Wiedergabe derselben Animationsvariablen vorhanden sind, ist der Versuch erfolgreich, und das Storyboard beginnt sofort mit der Wiedergabe.
Wenn das Storyboard Priorität hat, konfliktierende Storyboards abzubrechen, zu kürzen, abzuschließen oder zu komprimieren, ist der Versuch, einen Zeitplan zu planen, erfolgreich, und das Storyboard beginnt so schnell wie möglich mit der Wiedergabe.
Wenn das Storyboard keine Priorität hat, schlägt der Versuch fehl, und der schedulingResult-Parameter ist auf UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY festgelegt.

Wenn diese Methode von einem Handler für OnStoryboardStatusChanged-Ereignisse aufgerufen wird, wird der schedulingResult-Parameter auf UI_ANIMATION_SCHEDULING_DEFERRED festgelegt. Die einzige Möglichkeit, um festzustellen, ob das Storyboard erfolgreich geplant ist, besteht darin, einen Storyboard-Ereignishandler festzulegen und zu überprüfen, ob die status des Storyboards jemals UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY wird.

Es ist möglich, ein Storyboard wiederzuverwenden, indem Sie Schedule erneut aufrufen, nachdem die status UI_ANIMATION_STORYBOARD_READY erreicht hat. Ein Versuch, ein Storyboard zu planen, wenn es sich in einem anderen Zustand als UI_ANIMATION_STORYBOARD_BUILDING oder UI_ANIMATION_STORYBOARD_READY befindet, schlägt fehl, und schedulingResult ist auf UI_ANIMATION_SCHEDULING_ALREADY_SCHEDULED festgelegt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8, Windows 7 und Plattformupdate für Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	uianimation.h
DLL	UIAnimation.dll