IUIAnimationManager2::GetStoryboardFromTag-Methode (uianimation.h)

Artikel
08/26/2023

Ruft das Storyboard mit dem angegebenen Tag ab.

Syntax

HRESULT GetStoryboardFromTag(
  [in, optional] IUnknown                *object,
  [in]           UINT32                  id,
  [out]          IUIAnimationStoryboard2 **storyboard
);

Parameter

[in, optional] object

Der Objektteil des Tags. Dieser Parameter kann NULL sein.

[in] id

Der Bezeichnerteil des Tags.

[out] storyboard

Das Storyboard, das dem angegebenen Tag entspricht, 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 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 Objektparameter NULL sein.

Tags sind nicht unbedingt eindeutig. Diese Methode gibt UI_E_AMBIGUOUS_MATCH zurück, wenn mehr als ein Storyboard 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

Freigeben über