InkEdit.SelInks-Eigenschaft

Artikel
10/28/2008

Ruft das Array eingebetteter Ink-Objekte (wenn diese als Freihandeingaben angezeigt werden) in der aktuellen Auswahl ab oder legt dieses fest.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public Property SelInks As Ink()
'Usage
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[])

Eigenschaftenwert

Typ: array<Microsoft.Ink.Ink[]
Die eingebetteten Ink-Objekte (wenn diese als Freihandeingaben angezeigt werden) in der aktuellen Auswahl.

Hinweise

Freihandeingaben werden im InkEdit-Steuerelement als Freihandeingaben angezeigt, wenn die InkInsertMode-Eigenschaft auf InsertAsInk festgelegt wurde.

Freihandeingaben müssen erkannt werden, bevor Sie über diese Eigenschaft darauf zugreifen können. Wenn die Freihandeingaben nicht erkannt werden, enthält die SelInks-Eigenschaft 0 (Null) Ink-Objekte. Sie müssen entweder die Recognize-Methode aufrufen (wenn der RecoTimeout-Wert gleich 0 (Null) ist) oder warten, bis die Freihandeingabe automatisch erkannt wird (wenn der RecoTimeout-Wert größer als 0 (Null) ist), um über diese Eigenschaft darauf zugreifen zu können.

Das InkEdit-Steuerelement ignoriert alle DrawingAttributes-Attribute für Freihandeingaben, die über die SelInks-Eigenschaft festgelegt wurden. Stattdessen übernimmt es alternative Zeichnungsattribute, die den Attributen nahegelegenen Texts entsprechen.

Diese Eigenschaft ist nur zur Laufzeit verfügbar. Zum Auswählen der Freihandeingaben verwenden Sie die Select-Methode.

Beispiele

In diesem Beispiel wird jedes Ink-Objekt in der SelInks-Eigenschaft im Format Ink Serialized Format (ISF) in einer Datei gespeichert.

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);
        }
    }
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.