IUIAnimationManager2::GetStoryboardFromTag メソッド (uianimation.h)

指定したタグを持つストーリーボードを取得します。

構文

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

パラメーター

[in, optional] object

タグのオブジェクト部分。 このパラメーターは、NULL でもかまいません。

[in] id

タグの識別子部分。

[out] storyboard

指定したタグに一致するストーリーボード。一致するものが見つからない場合は NULL 。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 Windows アニメーション エラー コード 」を参照してください。

解説

タグは、整数識別子 (id) と COM オブジェクト (オブジェクト) のペアリングです。 アプリケーションでは、タグを使用してアニメーション変数とストーリーボードを識別できます。 NULL はタグの有効なオブジェクト コンポーネントです。したがって、 オブジェクト パラメーターは NULL にすることができます。

タグは必ずしも一意ではありません。このメソッドは、指定したタグを持つ複数のストーリーボードが存在する場合にUI_E_AMBIGUOUS_MATCHを返します。

要件

サポートされている最小のクライアント	Windows 8、Windows 7、および Windows 7 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	uianimation.h
[DLL]	UIAnimation.dll

関連項目

IUIAnimationManager2

IUIAnimationStoryboard2

IUIAnimationStoryboard::GetTag

IUIAnimationStoryboard::SetTag