Cursor.Inverted-Eigenschaft

Artikel
10/28/2008

Ruft einen Wert ab, der angibt, ob der Cursor das umgekehrte Ende des Stifts ist.

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

Syntax

'Declaration
Public ReadOnly Property Inverted As Boolean
'Usage
Dim instance As Cursor
Dim value As Boolean

value = instance.Inverted

public bool Inverted { get; }

public:
property bool Inverted {
    bool get ();
}

/** @property */
public boolean get_Inverted()

public function get Inverted () : boolean

Eigenschaftenwert

Typ: System.Boolean
true , wenn der Cursor das umgekehrte Ende des Stifts ist, false, wenn der Cursor nicht das umgekehrte Ende des Stifts ist oder der Stift keinen Cursor unterstützt, der dem umgekehrten Ende des Stifts zugeordnet ist.

Hinweise

Umgekehrte Cursor sind in der Regel Löschvorgängen zugeordnet; ein bekannter Stift verfügt daher möglicherweise über ein Ende für das Zeichnen von Freihandeingaben und ein Ende für das Löschen von Strichen. Dennoch beschränkt sich die Erkennung umgekehrter Enden eines Stifts durch das System nicht auf Löschvorgänge. Der Inverted-Eigenschaft können Sie jedes zulässige Cursorverhalten zuordnen.

Weitere Informationen zum Löschen von Freihandeingaben finden Sie unter Erasing Ink with the Pen.

Hinweis

Ob Sie die Inverted-Eigenschaft verwenden, hängt ganz von den Anforderungen der Anwendung ab. Anwendungen müssen umgekehrte Cursor nicht zwingend prüfen, und das Freihanderfassungsmodul wendet Standardzeichnungsattribute in der gleichen Weise auf umgekehrte Cursor wie auf nicht umgekehrte Cursor an.

Hinweis

Diese Funktion kann rekursiv ausgeführt werden, wenn sie in bestimmten Meldungshandlern aufgerufen wird, und unerwartete Ergebnisse verursachen. Vermeiden Sie unbedingt den wieder eintretenden Aufruf, wenn Sie eine der folgenden Meldungen behandeln: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT sowie WM_SYSCOMMAND, wenn wParam auf SC_HOTKEY oder SC_TASKLIST festgelegt ist, und WM_SYSKEYDOWN (wenn die Tastenkombinationen ALT+TAB oder ALT+ESC verarbeitet werden). Dieses Problem tritt bei Anwendungen des Singlethread-Apartment-Modells auf.

Beispiele

In diesem C#-Beispiel wird ein Bericht über die Attribute aller Cursor zurückgegeben, die von dem als Parameter übergebenen InkCollector-Objekt gefunden werden.

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

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

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

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.