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 です。
[in, optional] CompressionMode
省略可能。 永続化されたインクの圧縮モードを指定する InkPersistenceCompressionMode 値の 1 つ。 既定値は IPCM_Default です。
[out, retval] Data
このメソッドから制御が戻るときに、永続化されたインクを含むバイト配列が格納されます。
VARIANT 構造体の詳細については、「 COM ライブラリの使用」を参照してください。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
メソッド内で例外が発生しました。 |
|
圧縮モードが無効です。 |
|
バイト配列を割り当てることができません。 |
|
空の Ink オブジェクトを GIF 形式で保存しようとすると発生します。 |
注釈
空の InkDisp オブジェクトを GIF 形式で保存しようとすると、エラーが発生します。
メモInkPersistenceFormat 値が Base64InkSerializedFormat の Save メソッドを呼び出すと、戻り値は NULL で終わるバイト配列になります。 保存したインクを XML ファイルに書き込むには、最初に配列から最後のバイトを削除してから、配列を 8 ビット Unicode 変換形式 (UTF-8) エンコード文字列に変換します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |