IUIAnimationManager::GetVariableFromTag-Methode (uianimation.h)

Ruft die Animationsvariable mit dem angegebenen Tag ab.

Syntax

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

Parameter

[in, optional] object

Der Objektteil des Tags. Dieser Parameter kann NULL sein.

[in] id

Der Bezeichnerteil des Tags.

[out] variable

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

Rückgabewert

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

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 ObjektparameterNULL sein.

Tags sind nicht unbedingt eindeutig. Diese Methode gibt UI_E_AMBIGUOUS_MATCH zurück, wenn mehrere Animationsvariablen mit dem angegebenen Tag vorhanden sind.

Anforderungen

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

Weitere Informationen

IUIAnimationManager

IUIAnimationVariable

IUIAnimationVariable::GetTag

IUIAnimationVariable::SetTag