Metodo IUIAnimationStoryboard2::Schedule (uianimation.h)

Articolo
08/26/2023

Indirizza lo storyboard per pianificare se stesso per giocare.

Sintassi

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

Parametri

[in] timeNow

Ora corrente.

[out, optional] schedulingResult

Risultato della richiesta di pianificazione. È possibile omettere questo parametro dalle chiamate a questo metodo.

Valore restituito

Restituisce S_OK se ha esito positivo; in caso contrario, un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore dell'animazione di Windows .

Commenti

Questo metodo indirizza un storyboard per provare ad aggiungere se stesso alla pianificazione dei storyboard, usando queste regole:

Se non sono presenti storyboard che animano alcuna delle stesse variabili di animazione, il tentativo ha esito positivo e il storyboard inizia immediatamente a giocare.
Se lo storyboard ha la priorità di annullare, tagliare, concludere o comprimere storyboard in conflitto, il tentativo di pianificare ha esito positivo e il storyboard inizia a giocare il prima possibile.
Se lo storyboard non ha priorità, il tentativo ha esito negativo e il parametro schedulingResult è impostato su UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY.

Se questo metodo viene chiamato da un gestore per gli eventi OnStoryboardStatusChanged , il parametro schedulingResult è impostato su UI_ANIMATION_SCHEDULING_DEFERRED. L'unico modo per determinare se lo storyboard è pianificato correttamente è impostare un gestore eventi storyboard e verificare se lo stato dello storyboard diventa mai UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY.

È possibile riutilizzare uno storyboard chiamando di nuovo Pianificazione dopo che lo stato ha raggiunto UI_ANIMATION_STORYBOARD_READY. Un tentativo di pianificare uno storyboard quando si trova in qualsiasi stato diverso da UI_ANIMATION_STORYBOARD_BUILDING o UI_ANIMATION_STORYBOARD_READY ha esito negativo e la pianificazioneResult è impostata su UI_ANIMATION_SCHEDULING_ALREADY_SCHEDULED.

Requisiti


Client minimo supportato	Windows 8, Windows 7 e Platform Update per Windows 7 [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	uianimation.h
DLL	UIAnimation.dll