次の方法で共有

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

  • [アーティクル]

インクを指定した InkPersistenceFormat に変換し、指定した InkPersistenceCompressionMode を使用してインクを保存し、バイナリ データをバイト配列で返します。

構文

HRESULT Save(
  [in, optional] InkPersistenceFormat          PersistenceFormat,
  [in, optional] InkPersistenceCompressionMode CompressionMode,
  [out, retval]  VARIANT                       *Data
);

パラメーター

[in, optional] PersistenceFormat

任意。 永続化されたインクの形式を示す InkPersistenceFormat 値のいずれかを設定します。 既定値は InkSerializedFormat です。

名前 説明
InkSerializedFormat
 インクは、インクシリアル化形式 (ISF) を使用して永続化されます。

これは最もコンパクトなインクの永続表現です。 バイナリ ドキュメント形式への埋め込みまたはクリップボードへの直接配置を実行できます。 これが既定値です。
Base64InkSerializedFormat
 インクは、ISF を base64 ストリームとしてエンコードすることによって保持されます。

この形式は、インクを拡張マークアップ言語 (XML) または HTML ファイルで直接エンコードできるように提供されます。
Gif
 インクは、ファイル内に埋め込まれたメタデータとして ISF を含むグラフィックス交換形式 (GIF) ファイルを使用して保持されます。

これにより、インクが有効になっていないアプリケーションでインクを表示し、インク対応アプリケーションに戻ったときに完全なインクの忠実性を維持できます。 この形式は、HTML ファイル内でインク コンテンツを転送し、インク対応アプリケーションとインク認識アプリケーションで使用できる場合に最適です。
Base64Gif
 インクは、base64 エンコードされた強化を使用して永続化されます。

この GIF 形式は、後で画像に変換して XML または HTML ファイルにインクを直接エンコードする場合に提供されます。 これは、すべてのインク情報を含めるために生成され、拡張スタイルシート言語変換 (XSLT) を介して HTML を生成する方法として使用される XML 形式で使用できます。

[in, optional] CompressionMode

省略可能。 永続化されたインクの圧縮モードを指定する InkPersistenceCompressionMode 値の 1 つ。 既定値は IPCM_Default です。

名前 説明
IPCM_Default
 一般的なアプリケーションの保存時間とストレージの最適なトレードオフが必要な場合に使用されます。
IPCM_MaximumCompression
 インクの保存速度よりも保存領域を最小限に抑える方が重要な場合に使用されます。
IPCM_NoCompression
 使用されているストレージ領域の量よりも保存時間が重要な場合、およびバージョン間の互換性が重要な場合に使用されます。

[out, retval] Data

このメソッドから制御が戻るときに、永続化されたインクを含むバイト配列が格納されます。

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

戻り値

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

リターン コード 説明
S_OK
 正常終了しました。
E_POINTER
 パラメーターに無効なポインターが含まれていました。
E_INK_EXCEPTION
 メソッド内で例外が発生しました。
E_INVALIDARG
 圧縮モードが無効です。
E_OUTOFMEMORY
 バイト配列を割り当てることができません。
E_UNEXPECTED
 空の Ink オブジェクトを GIF 形式で保存しようとすると発生します。

注釈

空の InkDisp オブジェクトを GIF 形式で保存しようとすると、エラーが発生します。

メモInkPersistenceFormat 値が Base64InkSerializedFormat の Save メソッドを呼び出すと、戻り値は NULL で終わるバイト配列になります。 保存したインクを XML ファイルに書き込むには、最初に配列から最後のバイトを削除してから、配列を 8 ビット Unicode 変換形式 (UTF-8) エンコード文字列に変換します。
 

要件

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

こちらもご覧ください

IInkDisp

InkDisp クラス

InkPersistenceCompressionMode 列挙

InkPersistenceFormat 列挙

Load メソッド