次の方法で共有


IInkExtendedProperties::Add メソッド (msinkaut.h)

IInkExtendedProperty オブジェクトを作成して IInkExtendedProperties コレクションに追加します。

構文

HRESULT Add(
  [in]          BSTR                 Guid,
  [in]          VARIANT              Data,
  [out, retval] IInkExtendedProperty **InkExtendedProperty
);

パラメーター

[in] Guid

新しい IInkExtendedProperty オブジェクトの 名前。 名前は、次の形式でグローバル一意識別子 (GUID) を表す BSTR として表されます。

{dfc71f44-354b-4ca1-93d7-7459410b6343}(中かっこを含む)

BSTR データ型の詳細については、「 COM ライブラリの使用」を参照してください。

[in] Data

新しい IInkExtendedProperty オブジェクトの データ。

VARIANT 構造体の詳細については、「 COM ライブラリの使用」を参照してください。

[out, retval] InkExtendedProperty

このメソッドから制御が戻るときに、新しい拡張プロパティへのポインターが格納されます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
正常終了しました。
E_POINTER
パラメーターに無効なポインターが含まれていました。
E_INVALIDARG
ユーザーがデータを指定しませんでした。
CO_E_CLASSSTRING
GUID 形式が無効です。
E_INK_EXCEPTION
メソッド内で例外が発生しました。
TPC_E_INVALID_STROKE
ストロークが無効です。

注釈

メモ 空の IInkExtendedProperty オブジェクトを 格納することはできません。 オブジェクトを格納するには、その前にデータが含まれている必要があります。 たとえば、後で使用するためにストロークに拡張プロパティを追加しようとすると、拡張プロパティにデータが含まれない場合、例外がスローされます。
 
次の型を使用できます。
  • バイト配列または CHAR 配列
  • 整数、浮動小数点数、大きい整数、倍精度浮動小数点、日付、または 10 進数の配列
  • ブール値 (ただし、ブール値の配列ではありません)
  • BSTR (ただし、BSTR の配列ではありません)
  • バリアント型 (Variant) の配列。 IInkExtendedProperty として渡されるバリアントのすべての配列は、同じ型であり、すべて数値である必要があります。 たとえば、BSTRS のバリアント配列、配列の配列、VT_NULL、VT_EMPTYはサポートされていません。
メモ このメソッドを呼び出し、 Guid パラメーターを IInkExtendedProperties コレクションに既に存在する GUID に設定すると、新しいデータは、2 つ目の要素を追加するのではなく、その GUID の既存の拡張プロパティを置き換えます。
 

要件

要件
サポートされている最小のクライアント Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー msinkaut.h
Library InkObj.dll

こちらもご覧ください

IInkExtendedProperties インターフェイス

InkStrokes コレクション