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.

Примеры

В следующем примере показан обработчик на одной кнопке, которая при выполнении будет задавать IsEnabledfalse на другой именованной кнопке 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 для определенных элементов, часто во время выполнения. Поэтому значение по умолчанию, указанное здесь, иногда не действует. Например, ScrollBar будет IsEnabledfalse всякий раз, когда определено, что нет необходимости поддерживать полосу прокрутки. При попытке задать это значение также может быть переопределено значением, возвращаемым IsEnabledCore.

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

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

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

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

• IsEnabledChanged