UIElement.IsEnabled 属性

定义

命名空间:

System.Windows

程序集:

PresentationCore.dll

获取或设置一个值，该值指示是否在用户界面（UI）中启用此元素。 这是一个依赖属性。

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。

示例

以下示例显示了一个按钮上的处理程序，在执行时将在另一个命名按钮上设置 IsEnabledfalseb1。

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 的特定于类的实现的影响，通常在运行时。 因此，此处列出的默认值有时无效。 例如，只要确定不需要支持滚动条，就会 IsEnabledfalseScrollBar。 尝试设置此值也可能被 IsEnabledCore返回的值重写。

未启用的元素不参与命中测试或焦点，因此不会是输入事件的源。

Dependency 属性信息

标识符字段	IsEnabledProperty
设置为 true 的元数据属性	没有

另请参阅

• IsEnabledChanged