InkOverlay.Cursors, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient la collection Cursors disponible dans la région d'entrée 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 InkOverlay
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 d'entrée 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 à un objet InkOverlay.

Tous les nouveaux curseurs que l'objet InkOverlay 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 InkOverlay les rencontre.

Lorsque vous activez une souris en tant que périphérique d'entrée sur l'objet InkOverlay (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 InkOverlay 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 InkOverlay passé en tant que paramètre.

using Microsoft.Ink;
//. . .
public string CursorReport(InkOverlay theInkOverlay)
{
    string theReport = "The InkOverlay has encountered the following cursors so far:" + Environment.NewLine;
    // Get the Cursors collection from the InkOverlay
    Microsoft.Ink.Cursors theCursors = theInkOverlay.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 InkOverlay passé en tant que paramètre.

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