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

このコンテンツに設定されているタグオブジェクトを取得します。

構文

HRESULT GetTag(
  [in]            REFIID riid,
  [out, optional] void   **object,
  [out, optional] UINT32 *id
);

[in] riid

使用するインターフェイスの識別子への参照。タグオブジェクトは、通常、このインターフェイスを実装します。

[out, optional] object

タグオブジェクト。

[out, optional] id

タグの ID 部分。

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

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

GetTag は 、指定したインターフェイスのタグ値を照会し、そのインターフェイスへのポインターを返します。

タグは、整数 ID (ID) とコンポーネントオブジェクトモデル (COM) オブジェクト (オブジェクト) のペアリングです。アプリでモーションを識別するために使用できます。パラメーターは省略可能であるため、メソッドはタグ、識別子部分、またはタグオブジェクトの両方の部分を返すことができます。

次の例は、このメソッドの構文を示しています。

IUnknown* pObject;
UINT32 id;

HRESULT hr = pContent->GetTag(IID_PPV_ARGS(&pObject), &id);