FrameworkContentElement.Cursor Propriété

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

Valeur de propriété

Curseur à afficher. La valeur par défaut est définie conformément null à cette propriété de dépendance. Toutefois, la valeur par défaut pratique au moment de l’exécution provient de divers facteurs.

Exemples

L’exemple suivant définit le curseur sur une valeur personnalisée.

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

Remarques

Lors de la définition de cette propriété en XAML, le processeur XAML s’appuie sur la conversion de type pour la Cursor classe afin d’évaluer la chaîne. La chaîne fournie doit évaluer une CursorType valeur. Pour plus d’informations, consultez Cursor.

Si le curseur tel qu’il est établi par cette propriété s’affiche ou ne s’affiche pas lorsque le pointeur de la souris se trouve sur cet élément dépend également de la valeur de la ForceCursor propriété. En outre, les considérations relatives aux événements telles qu’un glisser-déplacer actif, la capture de souris, les modes d’édition de texte dans les contrôles, et ainsi de suite, affectent également le curseur avec une priorité plus élevée que la valeur que vous spécifiez dans cette propriété.

Pour rétablir le comportement de définition de cette propriété sur la valeur par défaut éventuelle, définissez-la à null nouveau.

La null valeur par défaut signifie vraiment que la détermination de la valeur de curseur pratique est différée ici et doit être obtenue à partir d’un autre emplacement. Si aucune valeur par programmation n’est présentée à partir d’une source, le curseur par défaut sur une application WINDOWS Presentation Foundation (WPF) est une flèche.

Chaque mouvement de la souris sur une application WPF déclenche un QueryCursor événement. Les bulles d’événements et tout élément le long de l’itinéraire ont la possibilité de gérer l’événement et de définir la valeur du curseur via les arguments de cet événement. Dans ce cas, le fait que l’événement est géré et qu’il a une valeur modifiée dans les arguments est prioritaire sur la valeur de la Cursor propriété à tout niveau, sauf si ForceCursor elle est définie.

Si vous ne créez pas de curseur personnalisé, vous définissez généralement cette propriété sur une valeur de propriété statique de la Cursors classe.

La définition de la Cursor valeur personnalisée n’est pas activée dans une approbation partielle. Pour plus d’informations sur les curseurs personnalisés, consultez Vue d’ensemble de l’entrée.

Informations sur les propriétés de dépendance

Voir aussi

• QueryCursor
• ForceCursor
• OverrideCursor