UIElement.IsEnabled Свойство

Определение

Пространство имен:

System.Windows

Сборка:

PresentationCore.dll

Возвращает или задает значение, указывающее, включен ли этот элемент в пользовательском интерфейсе. Это свойство зависимостей.

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

Значение свойства

Boolean

Значение true, если данный элемент включен; в противном случае — значение false. Значение по умолчанию — true.

Примеры

В следующем примере показан обработчик одной кнопки, которая при выполнении будет установлена IsEnabled false на другой именованной кнопке 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

Комментарии

Обратите внимание, что это свойство зависит от реализаций определенных классов для определенных IsEnabledCore элементов, часто во время выполнения. Поэтому указанное здесь значение по умолчанию иногда не является эффективным. Например, когда определяется IsEnabled false, ScrollBar что не требуется поддерживать полосу прокрутки. При попытке задать это значение также может быть переопределено значением IsEnabledCore, возвращаемым .

Элементы, которые не включены, не участвуют в тестировании попадания или фокусе, поэтому не будут источниками входных событий.

Сведения о свойстве зависимостей

Поле идентификатора	IsEnabledProperty
Для свойств метаданных задано значение true	Нет

См. также раздел

• IsEnabledChanged