IUIAnimationManager::GetVariableFromTag メソッド (uianimation.h)

指定したタグを持つアニメーション変数を取得します。

構文

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

パラメーター

[in, optional] object

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

[in] id

タグの識別子部分。

[out] variable

指定したタグに一致するアニメーション変数。一致するものが見つからない場合は NULL 。

戻り値

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

注釈

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

タグは必ずしも一意ではありません。指定したタグを持つ複数のアニメーション変数が存在する場合、このメソッドは UI_E_AMBIGUOUS_MATCH を返します。

要件

こちらもご覧ください

IUIAnimationManager

IUIAnimationVariable

IUIAnimationVariable::GetTag

IUIAnimationVariable::SetTag