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.

C#

public System.Windows.Input.Cursor Cursor { get; set; }

Ö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.

C#

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;
        }
    }
}

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

Şunlara uygulanır

Ayrıca bkz.

• QueryCursor
• ForceCursor
• OverrideCursor