UIElement.IsEnabled プロパティ

定義

名前空間:

System.Windows

アセンブリ:

PresentationCore.dll

ユーザー インターフェイス (UI) でこの要素が有効かどうかを示す値を取得または設定します。 これは依存関係プロパティです。

C#

public bool IsEnabled { get; set; }

プロパティ値

Boolean

要素が有効になっている場合に true します。それ以外の場合は、falseします。 既定値は trueです。

例

次の例は、1 つのボタンのハンドラーを示しています。このハンドラーを実行すると、別の名前付きボタンに IsEnabledfalse が設定 b1。

C#

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!!";
    }

注釈

このプロパティは、実行時に多くの場合、特定の要素に対する IsEnabledCore のクラス固有の実装の影響を受けます。 そのため、ここで示す既定値は有効でない場合があります。 たとえば、スクロール バーをサポートする必要がないと判断されるたびに、ScrollBar が IsEnabledfalse されます。 この値を設定しようとすると、IsEnabledCoreによって返される値によってオーバーライドされる可能性もあります。

有効になっていない要素はヒット テストやフォーカスに参加しないため、入力イベントのソースになりません。

依存関係プロパティ情報

識別子フィールド	IsEnabledProperty
true に設定されたメタデータ プロパティ	何一つ

適用対象

こちらもご覧ください

• IsEnabledChanged