Ink.Save メソッド (PersistenceFormat, CompressionMode)

[アーティクル]
10/28/2008

Ink オブジェクトを指定された形式に変換し、指定された圧縮形式を使用して保存してから、Byte 配列でバイナリデータを返します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Function Save ( _
    p As PersistenceFormat, _
    c As CompressionMode _
) As Byte()
'使用
Dim instance As Ink
Dim p As PersistenceFormat
Dim c As CompressionMode
Dim returnValue As Byte()

returnValue = instance.Save(p, c)

public byte[] Save(
    PersistenceFormat p,
    CompressionMode c
)

public:
array<unsigned char>^ Save(
    PersistenceFormat p, 
    CompressionMode c
)

public byte[] Save(
    PersistenceFormat p,
    CompressionMode c
)

public function Save(
    p : PersistenceFormat, 
    c : CompressionMode
) : byte[]

パラメータ

p
型 : Microsoft.Ink.PersistenceFormat
PersistenceFormat 列挙体のメンバ。保持されるインクの形式を示します。

c
型 : Microsoft.Ink.CompressionMode
CompressionMode 列挙体のメンバ。保持されるインクの圧縮モードを指定します。

戻り値

型 : array<System.Byte[]
保持されるインクを含む Byte 配列。

解説

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

メモ :
p パラメータを Base64InkSerializedFormat に設定して Save メソッドを呼び出すと、戻り値は null で終わるバイト配列になります。保存済みのインクを XML ファイルに書き込むには、最初に配列の最後のバイトを削除してから、配列を 8 ビットの Unicode Transformation Format (UTF-8) でエンコードされた文字列に変換します。

p パラメータを Base64InkSerializedFormat に設定して Save メソッドを呼び出すと、戻り値は null で終わるバイト配列になります。保存済みのインクを XML ファイルに書き込むには、最初に配列の最後のバイトを削除してから、配列を 8 ビットの Unicode Transformation Format (UTF-8) でエンコードされた文字列に変換します。

例

この例では、InkOverlay オブジェクトの Ink オブジェクトが、Gif 形式でファイルに保存されます。CompressionMode は、NoCompression に設定されます。

Try
    ' FILE_NAME is a class level const
    Using FS As FileStream = New FileStream(FILE_NAME, FileMode.Create)
        Dim isf As Byte() = mInkOverlay.Ink.Save(PersistenceFormat.Gif, CompressionMode.NoCompression)
        FS.Write(isf, 0, isf.Length)
    End Using

Catch
    ' handle or rethrow
End Try

try
{
    // FILE_NAME is a class level const
    using (FileStream FS = new FileStream(FILE_NAME, FileMode.Create))
    {
        byte[] isf = mInkOverlay.Ink.Save(PersistenceFormat.Gif, CompressionMode.NoCompression);
        FS.Write(isf, 0, isf.Length);
    }
}
catch
{
    // handle or rethrow
}