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

Poniższy przykład przedstawia procedurę obsługi na jednym przycisku, który po wykonaniu zostanie ustawiony IsEnabled false 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 IsEnabledCore klasy 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 element ScrollBar będzie zawsze IsEnabled false , gdy zostanie określony, że nie ma potrzeby obsługi paska przewijania. Próba ustawienia tej wartości będzie również potencjalnie zastępowana przez wartość zwróconą przez IsEnabledCorewartość .

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

Informacje dotyczące właściwości zależności

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

Zobacz też

• IsEnabledChanged