UIElement.IsEnabled Свойство

Определение

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

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

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

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

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

Применяется к

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