UIElement.IsEnabled Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationCore.dll

Pobiera lub ustawia wartość wskazującą, czy ten element jest włączony w interfejsie użytkownika. Jest to właściwość zależności.

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

Wartość właściwości

Boolean

true, jeśli element jest włączony; w przeciwnym razie false. Wartość domyślna to true.

Przykłady

W poniższym przykładzie pokazano procedurę obsługi na jednym przycisku, który po wykonaniu ustawi IsEnabledfalse na innym nazwanym przycisku 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

Uwagi

Należy pamiętać, że ta właściwość ma wpływ na implementacje specyficzne dla klasy IsEnabledCore dla określonych elementów, często w czasie wykonywania. W związku z tym wartość domyślna wymieniona w tym miejscu czasami nie jest skuteczna. Na przykład ScrollBar będzie IsEnabledfalse za każdym razem, gdy zostanie określony, że nie ma potrzeby obsługi paska przewijania. Próba ustawienia tej wartości również potencjalnie zostanie zastąpiona przez wartość zwróconą przez IsEnabledCore.

Elementy, które nie są włączone, nie uczestniczą w testowaniu trafienia lub fokusie i dlatego nie będą źródłami zdarzeń wejściowych.

Informacje o właściwości zależności

Pole identyfikatora	IsEnabledProperty
Właściwości metadanych ustawione na true	Żaden

Zobacz też

• IsEnabledChanged