FrameworkElement.Cursor FrameworkElement.Cursor FrameworkElement.Cursor FrameworkElement.Cursor Property

Definition

Ruft den Cursor ab bzw. legt den Cursor fest, der angezeigt wird, wenn sich der Mauszeiger über diesem Element befindet.Gets or sets the cursor that displays when the mouse pointer is over this element.

public:
 property System::Windows::Input::Cursor ^ Cursor { System::Windows::Input::Cursor ^ get(); void set(System::Windows::Input::Cursor ^ value); };
public System.Windows.Input.Cursor Cursor { get; set; }
member this.Cursor : System.Windows.Input.Cursor with get, set
Public Property Cursor As Cursor

Eigenschaftswert

Der anzuzeigende Cursor.The cursor to display. Der Standardwert ist gemäß dieser Abhängigkeitseigenschaft als null definiert.The default value is defined as null per this dependency property. Der zur Laufzeit angewendete Standardwert resultiert jedoch aus einer Vielzahl von Faktoren.However, the practical default at run time will come from a variety of factors.

Beispiele

Das folgende Beispiel zeigt, wie die Grafik Cursor absichtlich festgelegt wird.The following example shows how to deliberately set the cursor graphic.

private void CursorTypeChanged(object sender, SelectionChangedEventArgs e)
{
    ComboBox source = e.Source as ComboBox;

    if (source != null)
    {
        ComboBoxItem selectedCursor = source.SelectedItem as ComboBoxItem;

        // Changing the cursor of the Border control 
        // by setting the Cursor property
        switch (selectedCursor.Content.ToString())
        {
            case "AppStarting":
                DisplayArea.Cursor = Cursors.AppStarting;
                break;
            case "ArrowCD":                        
                DisplayArea.Cursor = Cursors.ArrowCD;
                break;
            case "Arrow":
                DisplayArea.Cursor = Cursors.Arrow;
                break;
            case "Cross":
                DisplayArea.Cursor = Cursors.Cross;
                break;
            case "HandCursor":
                DisplayArea.Cursor = Cursors.Hand;
                break;
            case "Help":
                DisplayArea.Cursor = Cursors.Help;
                break;
            case "IBeam":
                DisplayArea.Cursor = Cursors.IBeam;
                break;
            case "No":
                DisplayArea.Cursor = Cursors.No;
                break;
            case "None":
                DisplayArea.Cursor = Cursors.None;
                break;
            case "Pen":
                DisplayArea.Cursor = Cursors.Pen;
                break;
            case "ScrollSE":
                DisplayArea.Cursor = Cursors.ScrollSE;
                break;
            case "ScrollWE":
                DisplayArea.Cursor = Cursors.ScrollWE;
                break;
            case "SizeAll":
                DisplayArea.Cursor = Cursors.SizeAll;
                break;
            case "SizeNESW":
                DisplayArea.Cursor = Cursors.SizeNESW;
                break;
            case "SizeNS":
                DisplayArea.Cursor = Cursors.SizeNS;
                break;
            case "SizeNWSE":
                DisplayArea.Cursor = Cursors.SizeNWSE;
                break;
            case "SizeWE":
                DisplayArea.Cursor = Cursors.SizeWE;
                break;
            case "UpArrow":
                DisplayArea.Cursor = Cursors.UpArrow;
                break;
            case "WaitCursor":
                DisplayArea.Cursor = Cursors.Wait;
                break;
            case "Custom":
                DisplayArea.Cursor = CustomCursor;
                break;
            default:
                break;
        }

        // If the cursor scope is set to the entire application
        // Use OverrideCursor to force the cursor for all elements
        if (cursorScopeElementOnly == false)
        {
            Mouse.OverrideCursor = DisplayArea.Cursor;
        }
    }
}
' When the Radiobox changes, a new cursor type is set
Private Sub CursorTypeChanged(ByVal sender As Object, ByVal e As SelectionChangedEventArgs)

    Dim item As String = CType(e.Source, ComboBox).SelectedItem.Content.ToString()

    Select Case item
        Case "AppStarting"
            DisplayArea.Cursor = Cursors.AppStarting
        Case "ArrowCD"
            DisplayArea.Cursor = Cursors.ArrowCD
        Case "Arrow"
            DisplayArea.Cursor = Cursors.Arrow
        Case "Cross"
            DisplayArea.Cursor = Cursors.Cross
        Case "HandCursor"
            DisplayArea.Cursor = Cursors.Hand
        Case "Help"
            DisplayArea.Cursor = Cursors.Help
        Case "IBeam"
            DisplayArea.Cursor = Cursors.IBeam
        Case "No"
            DisplayArea.Cursor = Cursors.No
        Case "None"
            DisplayArea.Cursor = Cursors.None
        Case "Pen"
            DisplayArea.Cursor = Cursors.Pen
        Case "ScrollSE"
            DisplayArea.Cursor = Cursors.ScrollSE
        Case "ScrollWE"
            DisplayArea.Cursor = Cursors.ScrollWE
        Case "SizeAll"
            DisplayArea.Cursor = Cursors.SizeAll
        Case "SizeNESW"
            DisplayArea.Cursor = Cursors.SizeNESW
        Case "SizeNS"
            DisplayArea.Cursor = Cursors.SizeNS
        Case "SizeNWSE"
            DisplayArea.Cursor = Cursors.SizeNWSE
        Case "SizeWE"
            DisplayArea.Cursor = Cursors.SizeWE
        Case "UpArrow"
            DisplayArea.Cursor = Cursors.UpArrow
        Case "WaitCursor"
            DisplayArea.Cursor = Cursors.Wait
        Case "Custom"
            DisplayArea.Cursor = CustomCursor
    End Select

    ' if the cursor scope is set to the entire application
    ' use OverrideCursor to force the cursor for all elements
    If (cursorScopeElementOnly = False) Then
        Mouse.OverrideCursor = DisplayArea.Cursor
    End If


End Sub

Hinweise

Wenn Sie diese Eigenschaft festlegen, XAMLXAML, wird die XAMLXAML Prozessor abhängig typkonvertierung für die Cursor Klasse zum Auswerten der Zeichenfolge.When you set this property in XAMLXAML, the XAMLXAML processor relies on type conversion for the Cursor class to evaluate the string. Die bereitgestellte Zeichenfolge ergeben sollten eine CursorType Wert.The provided string should evaluate to a CursorType value. Ausführliche Informationen finden Sie unter Cursor.See Cursor for details.

Ob der von dieser Eigenschaft festgelegte Cursor werden oder wird nicht angezeigt wird, wenn der Mauszeiger über diesem Element befindet ist auch abhängig von den Wert des der ForceCursor Eigenschaft.Whether the cursor as established by this property will or will not display when the mouse pointer is over this element is also dependent on the value of the ForceCursor property. Darüber hinaus wirkt ereignisbezogene Faktoren wie z. B. ein aktives ziehen, die Erfassung von Mauseingaben, Textbearbeitung-Modi Steuerelemente und So weiter, den Cursor mit höherer Priorität als der Wert sich auch, die Sie in dieser Eigenschaft angeben.Also, event-related considerations such as an active drag, mouse capture, text editing modes within controls, and so on, will also affect the cursor with higher priority than the value you specify in this property.

Um das Verhalten der Einstellung dieser Eigenschaft auf den tatsächlichen Standardwert wiederherzustellen, legen Sie ihn auf null erneut aus.To revert the behavior of setting this property to the eventual default, set it to null again.

Die null Standard wirklich bedeutet, dass Bestimmung der Wert der praktischen Cursor, hier verzögert wird und von einer anderen Stelle abgerufen werden sollen.The null default really means that determination of the practical cursor value is deferred here and should be obtained from elsewhere. Programmgesteuerte Werte aus beliebigen Quellen angezeigt, den Standardcursor, der ist visuell über eine Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) Anwendung wird ein Pfeil.If presented without programmatic values from any source, the default cursor that is visually over a Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) application will be an arrow. Ändert sich der vorübergehende Cursor sind jedoch nicht festgelegt, um die Cursor Werte der Elemente, wenn sie über übergeben werden.However, the transient cursor changes are not set to the Cursor values of the elements when they are passed over. Die Cursor Eigenschaft wird nur Null-Werte in Fällen, in dem sie tatsächlich, z. B. durch Code oder einem Stil festgelegt wurde.The Cursor property will only report non null values in cases where it was actually set, for instance through code or a style. Jede Bewegung der Maus über ein WPFWPF Anwendung löst eine QueryCursor Ereignis.Each movement of the mouse over a WPFWPF application raises a QueryCursor event. Das Ereignis weitergeleitet, und jedes Element entlang der Route hat die Möglichkeit zum Behandeln des Ereignisses und zum Festlegen des Werts, der den Cursor über die Argumente des Ereignisses.The event bubbles, and any element along the route has the opportunity to handle the event and to set the value of the cursor through the arguments of this event. Dies ist der Mechanismus, der den sichtbaren Cursor in den meisten Fällen erzeugt.This is the mechanism that produces the visually apparent cursor in most cases. Wenn eine QueryCursor Handler gibt eine Cursorergebnis zurück, und klicken Sie dann die Tatsache, dass das Ereignis behandelt wird, und verfügt über einen geänderten Wert in den Argumenten hat Vorrang vor den Wert des der Cursor Eigenschaft auf jeder Ebene, es sei denn, ForceCursor festgelegt ist.If a QueryCursor handler returns a cursor result, then the fact that the event is handled and has a changed value in the arguments takes precedence over the value of the Cursor property at any level, unless ForceCursor is set.

Wenn Sie keinen benutzerdefinierten Cursor erstellen, Sie in der Regel legen Sie diese Eigenschaft auf einen statischen Eigenschaft-Wert, der die Cursors Klasse.If not are not creating a custom cursor, you typically set this property to a static property value of the Cursors class. Festlegen von Cursor im Code erfordert eine der folgenden:Setting Cursor in code requires one of the following:

  • Rufen Sie die Cursor Konstruktor zum Abrufen einer Cursor Instanz.Call the Cursor constructor to get a Cursor instance. Beide Signaturen der Cursor Konstruktor verwenden, Streams oder Dateien, in der Erwartung, die Sie erstellen die Cursor -Objekt für einen benutzerdefinierten Cursor.Both signatures of the Cursor constructor use streams or files, in anticipation that you are creating the Cursor object for a custom cursor.

  • Verwenden der CursorConverter Klasse und die zugehörige ConvertFrom Methode, um einen Cursor durch angeben CursorType, oder eine Zeichenfolge, die zum Auswerten können eine CursorType, und die Rückgabe in Cursor.Use the CursorConverter class and its ConvertFrom method to specify a cursor by CursorType, or a string that can evaluate to a CursorType, and cast the return to Cursor.

Festlegen der Cursor auf einen benutzerdefinierten Wert ist bei teilweiser Vertrauenswürdigkeit nicht aktiviert.Setting the Cursor to a custom value is not enabled in partial trust. Weitere Informationen zu benutzerdefinierten Cursor finden Sie unter Übersicht über die Eingabe.For more information on custom cursors, see Input Overview.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field CursorProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true KeinerNone

Gilt für:

Siehe auch