FrameworkContentElement.Cursor Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient ou définit le curseur qui s'affiche lorsque le pointeur de la souris est sur cet élément.

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é

Cursor

Curseur à afficher. La valeur par défaut est null conformément à cette propriété de dépendance. Toutefois, la valeur pratique par défaut 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 être évaluée à une CursorType valeur. Pour plus d'informations, consultez Cursor.

Le fait que le curseur tel qu’é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 liées aux événements, telles qu’un glisser-glisser actif, la capture de la souris, les modes d’édition de texte dans les contrôles, etc., affecteront é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 la définition de cette propriété sur la valeur par défaut éventuelle, définissez-la à nouveau sur null .

La null valeur par défaut signifie vraiment que la détermination de la valeur pratique du curseur est différée ici et doit être obtenue d’ailleurs. S’il n’y a aucune valeur programmatique provenant d’une source, le curseur par défaut sur une application Windows Presentation Foundation (WPF) est une flèche.

Chaque déplacement de la souris sur une application WPF déclenche un QueryCursor événement. Les bulles d’événement 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. Si cela se produit, le fait que l’événement soit géré et ait une valeur modifiée dans les arguments est prioritaire sur la valeur de la Cursor propriété à n’importe quel niveau, sauf si ForceCursor est défini.

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 sur Cursor une valeur personnalisée n’est pas activée en approbation partielle. Pour plus d’informations sur les curseurs personnalisés, consultez Vue d’ensemble des entrées.

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

Champ Identificateur	CursorProperty
Propriétés de métadonnées définies sur true	Aucun

Voir aussi

• QueryCursor
• ForceCursor
• OverrideCursor