InkCollector.Cursors, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient la collection Cursors disponible dans la région de saisie manuscrite.

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

Syntaxe

'Déclaration
Public ReadOnly Property Cursors As Cursors
'Utilisation
Dim instance As InkCollector
Dim value As Cursors

value = instance.Cursors

public Cursors Cursors { get; }

public:
property Cursors^ Cursors {
    Cursors^ get ();
}

/** @property */
public Cursors get_Cursors()

public function get Cursors () : Cursors

Valeur de propriété

Type : Microsoft.Ink.Cursors
Collection Cursors disponible pour la région de saisie manuscrite.

Notes

Les curseurs correspondent à la mine du stylet ou autre périphérique de saisie manuscrite.

Les curseurs de cette collection sont locaux à un objet InkCollector.

Tous les nouveaux curseurs que l'objet InkCollector rencontre sont ajoutés à la collection Cursors retournée, bien que les curseurs ne soient pas toujours retournés dans l'ordre dans lequel l'objet InkCollector les rencontre.

Lorsque vous activez une souris en tant que périphérique d'entrée sur l'objet InkCollector (lorsque le paramètre useMouseForInput de la méthode SetAllTabletsMode a la valeur true), la souris est ajoutée à la collection Cursors lorsque InkCollector rencontre d'autres curseurs, un stylet par exemple. Cela est dû au fait que le stylet fonctionne également comme une souris.

Remarque :
L'événement CursorInRange est reçu pour le curseur de la souris après tout autre curseur, comme lorsqu'un stylet dessine un trait (ce qui déclenche l'événement Stroke).

La collection Cursors est effacée (compte défini sur 0 et ne contenant aucun objet) lorsque :

Le mode de la tablette est modifié (par exemple, de SetSingleTabletIntegratedMode à SetAllTabletsMode).
La méthode SetSingleTabletIntegratedMode est appelée.

Exemples

Cet exemple C# retourne un rapport sur les attributs de tous les curseurs vus par l'objet InkCollector passé en tant que paramètre.

using Microsoft.Ink;
//. . .
public string CursorReport(InkCollector theInkCollector)
{
    string theReport = "The InkCollector has encountered the following cursors so far:" + Environment.NewLine;
    // Get the Cursors collection from the InkCollector
    Microsoft.Ink.Cursors theCursors = theInkCollector.Cursors;
    // Prevent changes to the collection while we iterate over it.
    lock( theCursors.SyncRoot )
    {
        theReport += "Count of cursors: " + theCursors.Count + Environment.NewLine + Environment.NewLine ;
        foreach (Microsoft.Ink.Cursor cursor in theCursors)
        {
            theReport += "Cursor Name: " + cursor.Name + Environment.NewLine;
            theReport += "Cursor ToString: " + cursor.ToString() + Environment.NewLine;
            theReport += "Tablet Name: " + cursor.Tablet.Name  + Environment.NewLine;
            theReport += "Cursor Id: " + cursor.Id.ToString()  + Environment.NewLine;
            theReport += "Cursor is inverted: " + cursor.Inverted.ToString()  + Environment.NewLine;
            theReport += "Cursor Buttons:" + Environment.NewLine;
            foreach (CursorButton button in cursor.Buttons)
            {
                CursorButtonState theState = button.State;
                theReport += "    Button Name: " + button.Name + Environment.NewLine;
                theReport += "    State: " + button.State.ToString() + Environment.NewLine;
                theReport += "    Id: " + button.Id.ToString()  + Environment.NewLine + Environment.NewLine;
            }
        }
    }
    return theReport;
}

Cet exemple Microsoft® Visual Basic® .NET retourne un rapport sur les attributs de tous les curseurs vus par l'objet InkCollector passé en tant que paramètre.

Imports Microsoft.Ink
'. . .
Public Function CursorReport(ByVal theInkCollector As InkCollector) _
    As String
    Dim theReport As String = "The InkCollector has encountered " & _
        "the following cursors so far:" & vbCrLf
    ' Get the Cursors collection from the InkCollector
    Dim theCursors As Cursors = theInkCollector.Cursors
    ' Prevent changes to the collection while we iterate over it.
    SyncLock theCursors.SyncRoot
        theReport &= "Count of cursors: " & theCursors.Count & vbCrLf
        Dim theCursor As Cursor
        For Each theCursor In theCursors
            theReport &= "Cursor Name: " & theCursor.Name & vbCrLf
            theReport &= "Cursor ToString: " & theCursor.ToString() & _
                vbCrLf
            theReport &= "Tablet Name: " & theCursor.Tablet.Name & vbCrLf
            theReport &= "Cursor Id: " & theCursor.Id.ToString() & vbCrLf
            theReport &= "Cursor is inverted: " & _
                theCursor.Inverted.ToString() & vbCrLf
            theReport &= "Cursor Buttons:" & vbCrLf
            Dim theButton As CursorButton
            For Each theButton In theCursor.Buttons
                Dim theState As CursorButtonState = theButton.State
                theReport &= "    Button Name: " & theButton.Name & vbCrLf
                theReport &= "    State: " & _
                    theButton.State.ToString() & vbCrLf
                theReport &= "    Id: " & theButton.Id.ToString() & _
                    vbCrLf & vbCrLf
            Next
        Next
    End SyncLock
    Return theReport
End Function

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.