Freigeben über


InkPicture.Cursors-Eigenschaft

Ruft die Cursors-Auflistung ab, die für die Verwendung im Freihandzeichnungsbereich verfügbar ist.

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

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public ReadOnly Property Cursors As Cursors
'Usage
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

Eigenschaftenwert

Typ: Microsoft.Ink.Cursors
Die Cursors-Auflistung, die für die Verwendung im Freihandzeichnungsbereich verfügbar ist.

Hinweise

Jeder Cursor entspricht der Spitze eines Stifts oder eines sonstigen Freihand-Eingabegeräts.

Die Cursor in dieser Auflistung sind lokale Cursor für ein InkPicture-Steuerelement.

Neue, vom InkPicture-Steuerelement gefundene Cursor werden der zurückgegebenen Cursors-Auflistung hinzugefügt, obwohl die Cursor nicht unbedingt in der Reihenfolge zurückgegeben werden, in der das InkPicture-Steuerelement sie findet.

Wenn Sie eine Maus als Eingabegerät für das InkPicture-Steuerelement aktivieren (wenn der useMouseForInput-Parameter der SetAllTabletsMode-Methode true lautet), wird die Maus der Cursors-Auflistung hinzugefügt, nachdem InkPicture einen anderen Cursor wie einen Stift gefunden hat. Die Ursache hierfür ist, dass der Stift auch als Maus fungiert.

Hinweis

Das CursorInRange-Ereignis wird für den Mauszeiger nach jedem anderen Cursor empfangen, beispielsweise wenn ein Stift einen Strich zeichnet (wodurch das Stroke-Ereignis ausgelöst wird).

Die Cursors-Auflistung wird unter folgenden Umständen geleert (die Anzahl auf 0 (null) festgelegt, sodass sie keine Objekte enthält):

Beispiele

In diesem C#-Beispiel wird ein Bericht über die Attribute aller Cursor zurückgegeben, die von dem im Parameter theInkPicture übergebenen InkPicture-Steuerelement gefunden werden.

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

In diesem Microsoft® Visual Basic® .NET-Beispiel wird ein Bericht über die Attribute aller Cursor zurückgegeben, die von dem im Parameter theInkPicture übergebenen InkPicture-Objekt gefunden werden.

[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

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.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

InkPicture-Klasse

InkPicture-Member

Microsoft.Ink-Namespace

InkPicture

Cursors

InkPicture.SetAllTabletsMode

InkPicture.SetSingleTabletIntegratedMode