FrameworkContentElement.Cursor Özellik

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationFramework.dll

Fare işaretçisi bu öğenin üzerindeyken görüntülenen imleci alır veya ayarlar.

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

Özellik Değeri

Cursor

Görüntülenecek imleç. Varsayılan değer bu bağımlılık özelliğine null göre tanımlanır. Ancak, çalışma zamanındaki pratik varsayılan değer çeşitli faktörlerden gelir.

Örnekler

Aşağıdaki örnek, imleci özel bir değere ayarlar.

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

Açıklamalar

XAML'de bu özelliği ayarlarken, XAML işlemcisi dizeyi değerlendirmek için sınıfın Cursor tür dönüştürmesine dayanır. Sağlanan dize bir CursorType değer olarak değerlendirilmelidir. Ayrıntılar için bkz. Cursor.

Bu özellik tarafından oluşturulan imlecin, fare işaretçisi bu öğenin üzerindeyken görüntülenip görüntülenmeyeceği de özelliğin ForceCursor değerine bağlıdır. Ayrıca etkin sürükleme, fare yakalama, denetimlerdeki metin düzenleme modları gibi olayla ilgili konular da imleci bu özellikte belirttiğiniz değerden daha yüksek önceliğe sahip şekilde etkiler.

Bu özelliği son varsayılana ayarlama davranışını geri döndürmek için yeniden olarak ayarlayın null .

Varsayılan null değer, pratik imleç değerinin belirlenmesinin burada erteleneceği ve başka bir yerden alınması gerektiği anlamına gelir. Herhangi bir kaynaktan programlı değer sunulmazsa, Windows Presentation Foundation (WPF) uygulamasının üzerindeki varsayılan imleç bir ok olacaktır.

Farenin WPF uygulaması üzerinde gerçekleştirilen her hareketi bir QueryCursor olay oluşturur. Olay kabarcıkları ve yol boyunca herhangi bir öğe, olayı işleme ve bu olayın bağımsız değişkenleri aracılığıyla imlecin değerini ayarlama fırsatına sahiptir. Böyle bir durumda, olayın işlenmesi ve bağımsız değişkenlerde değişen bir değere sahip olması, ayarlanmadığı sürece ForceCursor herhangi bir düzeyde özelliğin Cursor değerinden önceliklidir.

Özel bir imleç oluşturulmuyorsa, genellikle bu özelliği sınıfın Cursors statik özellik değerine ayarlarsınız.

Cursor değerinin özel bir değere ayarlanması kısmi güvende etkinleştirilmez. Özel imleçler hakkında daha fazla bilgi için bkz. Girişe Genel Bakış.

Bağımlılık Özelliği Bilgileri

Tanımlayıcı alanı	CursorProperty
Meta veri özellikleri olarak ayarlandı true	Hiçbiri

Ayrıca bkz.

• QueryCursor
• ForceCursor
• OverrideCursor