FrameworkContentElement.Cursor Eigenschaft

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. Der Standardwert wird gemäß null dieser Abhängigkeitseigenschaft definiert. Die praktische Standardeinstellung zur Laufzeit kommt jedoch aus einer Vielzahl von Faktoren.

Beispiele

Im folgenden Beispiel wird der Cursor auf einen benutzerdefinierten Wert festgelegt.

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)
        {
            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

Beim Festlegen dieser Eigenschaft in XAML basiert der XAML-Prozessor auf der Typkonvertierung für die Cursor Klasse, um die Zeichenfolge auszuwerten. Die angegebene Zeichenfolge sollte als CursorType Wert ausgewertet werden. Weitere Informationen finden Sie unter Cursor.

Gibt an, ob der Von dieser Eigenschaft festgelegte Cursor angezeigt wird oder nicht angezeigt wird, wenn sich der Mauszeiger über diesem Element befindet, auch vom Wert der ForceCursor Eigenschaft abhängig ist. Darüber hinaus wirken sich ereignisbezogene Überlegungen wie aktives Ziehen, Mauserfassung, Textbearbeitungsmodi in Steuerelementen usw. auch auf den Cursor mit höherer Priorität aus als der wert, den Sie in dieser Eigenschaft angeben.

Wenn Sie das Verhalten der Einstellung dieser Eigenschaft auf den letztendlichen Standardwert zurücksetzen möchten, legen Sie sie erneut fest null .

Der null Standardwert bedeutet wirklich, dass die Bestimmung des praktischen Cursorwerts hier zurückgestellt wird und von anderen Stellen abgerufen werden sollte. Wenn keine programmgesteuerten Werte aus einer Quelle angezeigt werden, ist der Standardcursor über eine Windows Presentation Foundation (WPF)-Anwendung ein Pfeil.

Jede Bewegung der Maus über eine WPF-Anwendung löst ein QueryCursor Ereignis aus. Die Ereignisblasen, und jedes Element entlang der Route hat die Möglichkeit, das Ereignis zu behandeln und den Wert des Cursors über die Argumente dieses Ereignisses festzulegen. In diesem Fall hat die Tatsache, dass das Ereignis behandelt wird und einen geänderten Wert in den Argumenten hat Vorrang vor dem Wert der Cursor Eigenschaft auf einer beliebigen Ebene, es sei denn ForceCursor , es wird festgelegt.

Wenn kein benutzerdefinierter Cursor erstellt wird, legen Sie diese Eigenschaft in der Regel auf einen statischen Eigenschaftswert der Cursors Klasse fest.

Das Festlegen des Cursor Werts auf einen benutzerdefinierten Wert ist in teilweiser Vertrauensstellung nicht aktiviert. Weitere Informationen zu benutzerdefinierten Cursorn finden Sie unter "Input Overview".

Informationen zur Abhängigkeitseigenschaft

Weitere Informationen

• QueryCursor
• ForceCursor
• OverrideCursor