InkEdit.SelInks, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit le tableau des objets Ink incorporés (si affiché comme une entrée manuscrite) dans la sélection active.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
<BrowsableAttribute(False)> _
Public Property SelInks As Ink()
'Utilisation
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[])

Valeur de propriété

Type : array<Microsoft.Ink.Ink[]
Objets Ink incorporés (si affichés comme une entrée manuscrite) dans la sélection active.

Notes

L'entrée manuscrite est affichée comme une entrée manuscrite dans le contrôle InkEdit si la propriété InkInsertMode a la valeur InsertAsInk.

Vous devez reconnaître l'entrée manuscrite avant d'y accéder via cette propriété. Si vous ne reconnaissez pas l'entrée manuscrite, la propriété SelInks ne contient pas d'objets Ink. Pour y accéder via cette propriété, vous devez, soit appeler la méthode Recognize (si la valeur RecoTimeout est égale à 0), soit attendre la reconnaissance automatique de l'entrée manuscrite (lorsque la valeur RecoTimeout est supérieure à 0).

Le contrôle InkEdit ignore tout DrawingAttributes de l'entrée manuscrite définie via la propriété SelInks. À la place, il applique d'autres attributs de dessin d'après les attributs de texte proche.

Cette propriété est disponible au moment de l'exécution uniquement. Pour sélectionner l'entrée manuscrite, utilisez la méthode Select (page pouvant être en anglais).

Exemples

Dans cet exemple, chaque objet Ink dans la propriété SelInks est enregistré dans un fichier à l'aide du format ISF (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);
        }
    }
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.