UIElement.IsEnabled Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dieses Element in der Benutzeroberfläche (UI) aktiviert ist. Dies ist eine Abhängigkeitseigenschaft.

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

Eigenschaftswert

Boolean

true, wenn das Element aktiviert ist; andernfalls false. Der Standardwert ist true.

Beispiele

Das folgende Beispiel zeigt einen Handler auf einer Schaltfläche, der bei ausführung IsEnabledfalse auf einer anderen benannten Schaltfläche b1festgelegt wird.

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

Hinweise

Beachten Sie, dass diese Eigenschaft von klassenspezifischen Implementierungen von IsEnabledCore für bestimmte Elemente beeinflusst wird, häufig zur Laufzeit. Daher ist der hier aufgelistete Standardwert manchmal nicht wirksam. Beispielsweise wird ein ScrollBar immer dann IsEnabledfalse, wenn festgestellt wird, dass keine Bildlaufleiste unterstützt werden muss. Der Versuch, diesen Wert festzulegen, wird möglicherweise auch durch den von IsEnabledCorezurückgegebenen Wert überschrieben.

Elemente, die nicht aktiviert sind, nehmen nicht an Treffertests oder Fokus teil und sind daher keine Quellen von Eingabeereignissen.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	IsEnabledProperty
Auf true festgelegte Metadateneigenschaften	Nichts

Weitere Informationen

• IsEnabledChanged