FrameworkContentElement.Cursor Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur kursor yang ditampilkan saat penunjuk mouse berada di atas elemen ini.

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

Nilai Properti

Cursor

Kursor yang akan ditampilkan. Nilai default didefinisikan sesuai null properti dependensi ini. Namun, default praktis pada durasi akan berasal dari berbagai faktor.

Contoh

Contoh berikut mengatur kursor ke nilai kustom.

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

Keterangan

Saat mengatur properti ini di XAML, prosesor XAML bergantung pada konversi jenis untuk Cursor kelas guna mengevaluasi string. String yang disediakan harus dievaluasi ke CursorType nilai. Lihat Cursor untuk detailnya.

Apakah kursor seperti yang ditetapkan oleh properti ini akan atau tidak akan ditampilkan ketika penunjuk mouse berada di atas elemen ini juga tergantung pada nilai ForceCursor properti. Selain itu, pertimbangan terkait peristiwa seperti seret aktif, tangkapan mouse, mode pengeditan teks dalam kontrol, dan sebagainya, juga akan memengaruhi kursor dengan prioritas yang lebih tinggi daripada nilai yang Anda tentukan dalam properti ini.

Untuk mengembalikan perilaku pengaturan properti ini ke default akhirnya, atur kembali ke null .

Default null benar-benar berarti bahwa penentuan nilai kursor praktis ditangguhkan di sini dan harus diperoleh dari tempat lain. Jika disajikan tanpa nilai terprogram dari sumber apa pun, kursor default melalui aplikasi Windows Presentation Foundation (WPF) akan menjadi panah.

Setiap gerakan mouse di atas aplikasi WPF memunculkan QueryCursor peristiwa. Gelembung peristiwa, dan elemen apa pun di sepanjang rute memiliki kesempatan untuk menangani peristiwa dan untuk mengatur nilai kursor melalui argumen peristiwa ini. Jika itu terjadi, fakta bahwa peristiwa ditangani dan memiliki nilai yang berubah dalam argumen lebih diutamakan daripada nilai Cursor properti pada tingkat apa pun, kecuali ForceCursor ditetapkan.

Jika tidak membuat kursor kustom, biasanya Anda mengatur properti ini ke nilai Cursors properti statis kelas.

Mengatur ke Cursor nilai kustom tidak diaktifkan dalam kepercayaan parsial. Untuk informasi selengkapnya tentang kursor kustom, lihat Gambaran Umum Input.

Informasi Properti Dependensi

Bidang pengidentifikasi	CursorProperty
Properti metadata diatur ke true	Tidak ada

Lihat juga

• QueryCursor
• ForceCursor
• OverrideCursor