FrameworkContentElement.Cursor Eigenschap

Definitie

Hiermee haalt u de cursor op die wordt weergegeven wanneer de muis aanwijzer op dit element wordt weergegeven.

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

Waarde van eigenschap

De cursor die moet worden weergegeven. De standaardwaarde wordt gedefinieerd volgens null deze afhankelijkheidseigenschap. De praktische standaardinstelling tijdens runtime komt echter uit verschillende factoren.

Voorbeelden

In het volgende voorbeeld wordt de cursor ingesteld op een aangepaste waarde.

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

Opmerkingen

Bij het instellen van deze eigenschap in XAML is de XAML-processor afhankelijk van typeconversie voor de Cursor klasse om de tekenreeks te evalueren. De opgegeven tekenreeks moet een CursorType waarde opleveren. Zie Cursor voor meer informatie.

Of de cursor die door deze eigenschap is ingesteld, wel of niet wordt weergegeven wanneer de muis aanwijzer boven dit element valt, is ook afhankelijk van de waarde van de ForceCursor eigenschap. Overwegingen met betrekking tot gebeurtenissen, zoals een actieve slepen, muisopname, tekstbewerkingsmodi binnen besturingselementen, enzovoort, hebben ook invloed op de cursor met een hogere prioriteit dan de waarde die u in deze eigenschap opgeeft.

Als u het gedrag van het instellen van deze eigenschap wilt terugzetten op de uiteindelijke standaardwaarde, stelt u deze opnieuw in null .

De null standaardwaarde betekent echt dat de bepaling van de praktische cursorwaarde hier wordt uitgesteld en ergens anders moet worden verkregen. Als er geen programmatische waarden uit een bron worden weergegeven, is de standaardcursor boven een Windows Presentation Foundation -toepassing (WPF) een pijl.

Elke beweging van de muis boven een WPF toepassing genereert een QueryCursor gebeurtenis. De gebeurtenisballonnen en elk element langs de route heeft de mogelijkheid om de gebeurtenis af te handelen en de waarde van de cursor in te stellen via de argumenten van deze gebeurtenis. Als dat gebeurt, heeft het feit dat de gebeurtenis wordt verwerkt en een gewijzigde waarde in de argumenten voorrang heeft op de waarde van de Cursor eigenschap op een willekeurig niveau, tenzij ForceCursor ingesteld.

Als u geen aangepaste cursor maakt, stelt u deze eigenschap doorgaans in op een statische eigenschapswaarde van de Cursors klasse.

Het instellen van de Cursor waarde op een aangepaste waarde is niet ingeschakeld in gedeeltelijke vertrouwensrelatie. Zie Invoeroverzicht voor meer informatie over aangepaste cursors.

Informatie over afhankelijkheidseigenschappen

Onderdeel Value
Id-veld CursorProperty
Eigenschappen van metagegevens ingesteld op true Geen

Van toepassing op

Zie ook