UIElement.IsEnabled Свойство

Определение

Получает или задает значение, указывающее, включен ли этот элемент в пользовательский интерфейсuser interface (UI).Gets or sets a value indicating whether this element is enabled in the пользовательский интерфейсuser interface (UI). Это свойство зависимостей.This is a dependency property.

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

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

Значение true, если элемент включен; в противном случае — значение false.true if the element is enabled; otherwise, false. Значение по умолчанию — true.The default value is true.

Примеры

В следующем примере показан обработчик для одной кнопки, которая при выполнении будет устанавливать IsEnabled false на другой именованной кнопке b1.The following example shows a handler on one button that when executed will set IsEnabled false on another named button 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 определенных элементов, часто во время выполнения.Note that this property is influenced by class-specific implementations of IsEnabledCore on particular elements, often at runtime. Таким образом, значение по умолчанию, указанное здесь, иногда не действует.Therefore, the default value listed here is sometimes not effective. Например, ScrollBar будет IsEnabled false всякий раз, когда определяется, что не требуется поддерживать полосу прокрутки.For instance, a ScrollBar will be IsEnabled false whenever it is determined that there is no need to support a scrollbar. Попытка задать это значение также может быть переопределена значением, возвращаемым IsEnabledCore.Attempting to set this value will also potentially be overridden by the value returned by IsEnabledCore.

Элементы, которые не включены, не участвуют в проверке нажатия или фокусе и поэтому не будут источниками событий ввода.Elements that are not enabled do not participate in hit testing or focus and therefore will not be sources of input events.

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

Поле идентификатораIdentifier field IsEnabledProperty
Для свойств метаданных задано значение trueMetadata properties set to true ОтсутствуютNone

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

Дополнительно