InkEdit.SelInks プロパティ

2008-10-28

現在の選択から埋め込みオブジェクト Ink (インクとして表示されている場合) の配列を取得または設定します。

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

構文

'宣言
<BrowsableAttribute(False)> _
Public Property SelInks As Ink()
'使用
Dim instance As InkEdit
Dim value As Ink()

value = instance.SelInks

instance.SelInks = value

[BrowsableAttribute(false)]
public Ink[] SelInks { get; set; }

[BrowsableAttribute(false)]
public:
property array<Ink^>^ SelInks {
    array<Ink^>^ get ();
    void set (array<Ink^>^ value);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public Ink[] get_SelInks()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_SelInks(Ink[] value)

public function get SelInks () : Ink[]
public function set SelInks (value : Ink[])

プロパティ値

型 : array<Microsoft.Ink.Ink[]
現在の選択の埋め込みオブジェクト Ink (インクとして表示されている場合)。

解説

InkInsertMode プロパティを InsertAsInk に設定した場合、インクは、InkEdit コントロールのインクとして表示されます。

このプロパティを使用してインクにアクセスする前にそのインクを認識する必要があります。インクを認識しない場合、SelInks プロパティには、Ink オブジェクトが含まれません。このプロパティを使用してインクにアクセスするには、Recognize メソッドを呼び出すか (RecoTimeout 値が 0 の場合)、インクが自動的に認識されるまで待機する (RecoTimeout 値が 0 より大きい場合) 必要があります。

InkEdit コントロールは、SelInks プロパティを使用して設定されたインクのすべての DrawingAttributes を無視します。代わりに、隣接するテキストの属性に従って別の描画属性が適用されます。

このプロパティは、実行時にのみ使用できます。インクを選択するには、Select メソッドを使用します。

例

この例では、SelInks プロパティにある各 Ink オブジェクトが Ink Serialized Format を使用してファイルに保存されます。

Private Sub SaveSelectedInk()

    ' if mInkEdit.InkInsertMode <> InkInsertMode.InsertAsInk
    ' or no ink is selected, then the SelInks array will have zero elements.
    ' Normally, we'd want to check this but for simplicty, we'll write the file anyway. 
    ' Therefore, the file might be zero bytes long.
    Using FS As FileStream = New FileStream("myInk.dat", FileMode.Create)
        For Each I As Ink In mInkEdit.SelInks
            Dim isf As Byte() = I.Save(PersistenceFormat.InkSerializedFormat)
            FS.Write(isf, 0, isf.Length)
        Next
    End Using
End Sub

private void SaveSelectedInk()
{
    // if mInkEdit.InkInsertMode != InkInsertMode.InsertAsInk
    // or no ink is selected, then the SelInks array will have zero elements.
    // Normally, we'd want to check this but for simplicty, we'll write the file anyway. 
    // Therefore, the file might be zero bytes long.
    using (FileStream FS = new FileStream("myInk.dat",FileMode.Create))
    {
        foreach (Ink I in mInkEdit.SelInks)
        {
            byte[] isf = I.Save(PersistenceFormat.InkSerializedFormat);
            FS.Write(isf, 0, isf.Length);
        }
    }
}