Metodo IUIAnimationInterpolator::GetDependencies (uianimation.h)

Articolo
03/09/2024

Ottiene gli aspetti dell'interpolatore che dipendono dal valore iniziale o dalla velocità passata a SetInitialValueAndVelocity o che dipendono dalla durata passata a SetDuration.

Sintassi

HRESULT GetDependencies(
  [out] UI_ANIMATION_DEPENDENCIES *initialValueDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *initialVelocityDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *durationDependencies
);

Parametri

[out] initialValueDependencies

Aspetti dell'interpolatore che dipendono dal valore iniziale passato a SetInitialValueAndVelocity.

[out] initialVelocityDependencies

Aspetti dell'interpolatore che dipendono dalla velocità iniziale passata a SetInitialValueAndVelocity.

[out] durationDependencies

Aspetti dell'interpolatore che dipendono dalla durata passata a SetDuration.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore di animazione di Windows .

Commenti

Questo metodo viene chiamato per identificare gli aspetti dell'interpolatore personalizzato interessati da determinati input: valore, velocità e durata. Per ognuno di questi input, l'interpolatore restituisce uno dei valori seguenti:

OR bit per bit di qualsiasi membro di UI_ANIMATION_DEPENDENCIES applicabile.
UI_ANIMATION_DEPENDENCY_NONE se nulla dipende dall'input.

Si consideri, ad esempio, un interpolatore (1) che accetta un valore finale come parametro, (2) che arriva sempre a un arresto graduale a quel valore finale e (3) la cui durata è determinata dalla differenza tra i valori finali e iniziali. L'interpolatore deve restituire UI_ANIMATION_DEPENDENCY_INTERMEDIATE_VALUES|UI_ANIMATION_DURATION per initialValueDependencies. Non deve restituire UI_ANIMATION_DEPENDENCY_FINAL_VALUE perché viene impostato quando viene creato l'interpolatore e non è interessato dal valore iniziale. Allo stesso modo, non deve restituire UI_ANIMATION_DEPENDENCY_FINAL_VELOCITY perché la pendenza della curva è definita come zero quando raggiunge il valore finale.

È importante che un interpolatore restituisca un set corretto di flag. Se un flag non è presente per un output, l'animazione di Windows presuppone che il parametro corrispondente non influisca sull'aspetto dei risultati dell'interpolatore. Ad esempio, se l'interpolatore personalizzato non include UI_ANIMATION_DEPENDENCY_FINAL_VALUE per initialVelocityDependencies, l'animazione di Windows può chiamare SetInitialValueAndVelocity con un parametro di velocità arbitraria, quindi chiamare GetFinalValue per determinare il valore finale. L'implementazione dell'interpolatore di GetFinalValue deve restituire lo stesso risultato indipendentemente dal parametro velocità passato a SetInitialValueAndVelocity perché l'interpolatore ha affermato che il valore finale della transizione non dipende dalla velocità iniziale.

Nota Se i flag restituiti per durationDependencies non includono UI_ANIMATION_DEPENDENCY_DURATION, SetDuration non verrà mai chiamato sull'interpolatore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	uianimation.h
DLL	UIAnimation.dll

Vedi anche

IUIAnimationInterpolator

UI_ANIMATION_DEPENDENCIES

Condividi tramite