IInkDisp::Load メソッド (msinkaut.h)

新しい InkDisp オブジェクトに既知のバイナリ データを設定します。

構文

HRESULT Load(
  [in] VARIANT Data
);

パラメーター

[in] Data

インク データを含むストリーム。

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

戻り値

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

リターン コード	説明
S_OK	正常終了しました。
E_INVALIDARG	VARIANT が正しい型 (バイト配列) ではありません。
E_OUTOFMEMORY	Streamにメモリを割り当てることができません。
E_UNEXPECTED	予期しないパラメーターまたはプロパティの種類。
E_INK_EXCEPTION	メソッド内で例外が発生しました。

注釈

インクは、ストロークを収集していない、または添付プロパティがない、新しい空の InkDisp オブジェクトにのみ読み込むことができます。 ストロークまたは添付プロパティを収集した InkDisp オブジェクトにインクを読み込もうとすると、 InkDisp オブジェクトからストロークまたはプロパティが削除された場合でも、例外がスローされます。 これは、ストローク ID の割り当て方法が原因で発生します。 ストロークには一意の ID が割り当てられ、インク オブジェクトからストロークが削除された場合でも、この ID は再利用されません。 つまり、InkDisp オブジェクトに ID が 1 のストロークが含まれていて、そのストロークを削除し、この InkDisp オブジェクトに別の InkDisp オブジェクトを読み込んだ場合、ストローク ID は 2 から始まります。 これは混乱を招くため、許可されません。

メモ空ではない InkDisp オブジェクトにインクを読み込もうとすると、Load を呼び出すと、InkDisp オブジェクト内のすべてのデータ (カスタム ストロークや拡張プロパティを含む) が失われます。

 

Save メソッドを使用すると、InkDisp オブジェクトのインクをグラフィックス交換形式 (GIF) 形式で保持できます。これは、バイト データの配列で構成されます (tla_gif永続化形式は InkPersistenceFormat 列挙型で指定されています)。 バイト データの配列を取得したら、バイト データの配列を別の InkDisp オブジェクトに読み込むことができます。 つまり、SAVE メソッドを呼び出し、GIF 形式ではないバイト配列を受け取った場合と同じ方法で、GIF 互換のバイト配列データを別の InkDisp オブジェクトに読み込むことができます。

メモ イメージを作成し、そのイメージをバイト配列として保持してから、そのバイト配列を別の InkDisp オブジェクトに読み込むことはできません。 これは、バイト配列データを GIF として読み込んだ後、タブレット PC でそのデータの形式を制御できないためです。 そのため、イメージをバイト配列に再度永続化した後、そのデータに対して Load を呼び出すことはできません。

 

要件

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

こちらもご覧ください

IInkDisp

InkDisp クラス

Save メソッド