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
このメソッドから制御が戻るときに、新しい拡張プロパティへのポインターが格納されます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
ユーザーがデータを指定しませんでした。 |
|
GUID 形式が無効です。 |
|
メソッド内で例外が発生しました。 |
|
ストロークが無効です。 |
注釈
メモ 空の 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 |