InkPicture.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
<BrowsableAttribute(False)> _
Public ReadOnly Property Cursors As Cursors
'Utilisation
Dim instance As InkPicture
Dim value As Cursors

value = instance.Cursors

[BrowsableAttribute(false)]
public Cursors Cursors { get; }

[BrowsableAttribute(false)]
public:
property Cursors^ Cursors {
    Cursors^ get ();
}

/** @property */
/** @attribute BrowsableAttribute(false) */
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 d'entrée manuscrite.

Les curseurs de cette collection sont locaux au contrôle InkPicture.

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

Lorsque vous activez une souris en tant que périphérique d'entrée sur le contrôle InkPicture (lorsque le paramètre useMouseForInput de la méthode SetAllTabletsMode a la valeur true), la souris est ajoutée à la collection Cursors après que InkPicture 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 le contrôle InkPicture passé dans le paramètre, theInkPicture.

[C#]

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

Cet exemple Microsoft® Visual Basic® .NET retourne un rapport sur les attributs de tous les curseurs vus par le contrôle InkPicture passé dans le paramètre, theInkPicture.

[Visual Basic]

Imports Microsoft.Ink
'. . .
Public Function CursorReport(ByVal theInkPicture As InkPicture) _
    As String
    Dim theReport As String = "The InkPicture has encountered " & _
        "the following cursors so far:" & vbCrLf
    ' Get the Cursors collection from the InkPicture
    Dim theCursors As Cursors = theInkPicture.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.