Freigeben über


IUIAnimationManager2::GetVariableFromTag-Methode (uianimation.h)

Ruft die Animationsvariable mit dem angegebenen Tag ab.

Syntax

HRESULT GetVariableFromTag(
  [in, optional] IUnknown              *object,
  [in]           UINT32                id,
  [out, retval]  IUIAnimationVariable2 **variable
);

Parameter

[in, optional] object

Der Objektteil des Tags. Dieser Parameter kann NULL sein.

[in] id

Der Bezeichnerteil des Tags.

[out, retval] variable

Die Animationsvariable, die mit dem angegebenen Tag übereinstimmt, oder NULL , wenn keine Übereinstimmung gefunden wird.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter Windows-Animationsfehlercodes .

Hinweise

Ein Tag ist eine Kopplung eines ganzzahligen Bezeichners (id) mit einem COM-Objekt (Objekt). Eine Anwendung kann Tags verwenden, um Animationsvariablen und Storyboards zu identifizieren. NULL ist eine gültige Objektkomponente eines Tags. Daher kann der Object-Parameter NULL sein.

Tags sind nicht unbedingt eindeutig. Diese Methode gibt UI_E_AMBIGUOUS_MATCH zurück, wenn mehr als eine Animationsvariable mit dem angegebenen Tag vorhanden ist.

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

Weitere Informationen

IUIAnimationManager2

IUIAnimationStoryboard2

IUIAnimationStoryboard::GetTag

IUIAnimationStoryboard::SetTag