UIElement.IsEnabled Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationCore.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen ini diaktifkan di antarmuka pengguna (UI). Ini adalah properti dependensi.

public:
 property bool IsEnabled { bool get(); void set(bool value); };

public bool IsEnabled { get; set; }

member this.IsEnabled : bool with get, set

Public Property IsEnabled As Boolean

Nilai Properti

Boolean

true jika elemen diaktifkan; jika tidak, false. Nilai defaultnya adalah true.

Contoh

Contoh berikut menunjukkan handler pada satu tombol yang ketika dijalankan akan mengatur IsEnabledfalse pada tombol bernama lain b1.

public partial class RoutedEventAddRemoveHandler {
    void MakeButton(object sender, RoutedEventArgs e)
    {
        Button b2 = new Button();
        b2.Content = "New Button";
        // Associate event handler to the button. You can remove the event 
        // handler using "-=" syntax rather than "+=".
        b2.Click  += new RoutedEventHandler(Onb2Click);
        root.Children.Insert(root.Children.Count, b2);
        DockPanel.SetDock(b2, Dock.Top);
        text1.Text = "Now click the second button...";
        b1.IsEnabled = false;
    }
    void Onb2Click(object sender, RoutedEventArgs e)
    {
        text1.Text = "New Button (b2) Was Clicked!!";
    }

Public Partial Class RoutedEventAddRemoveHandler
    Private Sub MakeButton(ByVal sender As Object, ByVal e As RoutedEventArgs)
        Dim b2 As Button = New Button()
        b2.Content = "New Button"
        AddHandler b2.Click, AddressOf Onb2Click
        root.Children.Insert(root.Children.Count, b2)
        DockPanel.SetDock(b2, Dock.Top)
        text1.Text = "Now click the second button..."
        b1.IsEnabled = False
    End Sub
    Private Sub Onb2Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
        text1.Text = "New Button (b2) Was Clicked!!"
    End Sub

Keterangan

Perhatikan bahwa properti ini dipengaruhi oleh implementasi IsEnabledCore khusus kelas pada elemen tertentu, sering kali pada runtime. Oleh karena itu, nilai default yang tercantum di sini terkadang tidak efektif. Misalnya, ScrollBar akan IsEnabledfalse setiap kali ditentukan bahwa tidak perlu mendukung bilah gulir. Upaya untuk mengatur nilai ini juga berpotensi akan ditimpa oleh nilai yang dikembalikan oleh IsEnabledCore.

Elemen yang tidak diaktifkan tidak berpartisipasi dalam pengujian atau fokus hit dan oleh karena itu tidak akan menjadi sumber peristiwa input.

Informasi Properti Dependensi

Bidang pengidentifikasi	IsEnabledProperty
Properti metadata diatur ke true	Tidak

Lihat juga

• IsEnabledChanged