Cursor.Inverted-Eigenschaft
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.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0