IDirectManipulationContent::SetTag メソッド (directmanipulation.h)

コンテンツのタグオブジェクトを指定します。

構文

HRESULT SetTag(
  [in] IUnknown *object,
  [in] UINT32   id
);

[in] object

タグのオブジェクト部分。

[in] id

タグの ID 部分。

メソッドが成功すると、 S_OKが返されます。そうでない場合は、HRESULT エラーコードを返します。

GetTag と SetTag は、外部 COM オブジェクトを 2 つの間に外部マッピングなしでコンテンツに関連付ける場合に便利です。また、コンテンツに対して生成されたコールバックに情報を渡すためにも使用できます。

タグは、整数 ID (id) とコンポーネントオブジェクトモデル (COM) オブジェクト (オブジェクト) のペアリングです。アプリは、コンテンツに関連付けられている任意のオブジェクトを格納および取得するために使用できます。

オブジェクト パラメーターは省略可能であるため、メソッドは識別子部分のみを設定できます。