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

定義

この要素が ユーザー インターフェイス (UI)user interface (UI) で有効かどうかを示す値を取得または設定します。Gets or sets a value indicating whether this element is enabled in the ユーザー インターフェイス (UI)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、それ以外の場合は falsetrue if the element is enabled; otherwise, false. 既定値は true です。The default value is true.

次の例では、ことを示しています、ハンドラーを 1 つのボタンの実行が設定されている場合IsEnabledfalseもう 1 つの名前付きのボタンで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なりますIsEnabledfalseスクロール バーをサポートする必要がないと判断されたときにします。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

適用対象

こちらもご覧ください