IUIAnimationManager::GetStoryboardFromTag-Methode (uianimation.h)

Ruft das Storyboard mit dem angegebenen Tag ab.

Syntax

HRESULT GetStoryboardFromTag(
  [in, optional] IUnknown               *object,
  [in]           UINT32                 id,
  [out]          IUIAnimationStoryboard **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 mit dem angegebenen Tag übereinstimmt, 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 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-ParameterNULL 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

Weitere Informationen

IUIAnimationManager

IUIAnimationStoryboard::GetTag

IUIAnimationStoryboard::SetTag