UIElement.IsEnabled UIElement.IsEnabled UIElement.IsEnabled UIElement.IsEnabled Property

Определение

Получает или задает значение, указывающее, включен ли этот элемент в пользовательский интерфейс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 NoneNone

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

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