Control.IsEnabled 属性

定义

获取或设置一个值,该值指示用户是否可以与控件交互。

public:
 property bool IsEnabled { bool get(); void set(bool value); };
bool IsEnabled();

void IsEnabled(bool value);
public bool IsEnabled { get; set; }
var boolean = control.isEnabled;
control.isEnabled = boolean;
Public Property IsEnabled As Boolean
<control IsEnabled="bool"/>

属性值

Boolean

bool

如果用户可以与控件交互,则为 true;否则为 false

注解

许多控件具有为 IsEnabled =false 调用的预定义视觉状态,例如标签中的“灰显”文本。

每当 IsEnabled 更改时,将触发 IsEnabledChanged 事件。 控件可能会处理此事件以更改视觉状态。 事件具有 DependencyPropertyChangedEventArgs 数据,因此无需使用自己的标志即可确定新旧值。

控件从其父控件继承 IsEnabled 属性。 例如,如果包含按钮的控件将 IsEnabled 设置为 false,则按钮的 IsEnabled 属性也为 false。 当父级的属性发生更改时,会针对值继承而更改的每个控件触发 IsEnabledChanged

控件逻辑在禁用时的行为方式对于每个控件而言可能有所不同。 但是,当 IsEnabled =false 时,这些行为将导致所有控件:

  • 控件无法接收键盘焦点或以编程方式聚焦。
  • 控件不会显示在选项卡序列中, (UIElement.TabIndex 的任何值) 忽略。
  • 对于命中测试,仍可以看到禁用的控件。 它本身无法处理任何输入事件。 但是,禁用的控件仍然可以源输入事件,并且输入路由事件可以气泡到可以处理它们的父级。

适用于

另请参阅