UIElement.IsEnabled Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob dieses Element in der Benutzeroberfläche (UI) aktiviert ist. Hierbei handelt es sich um 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

Im folgenden Beispiel wird ein Handler auf einer Schaltfläche angezeigt, die beim Ausführen auf einer anderen benannten Schaltfläche b1festgelegt IsEnabled false 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 bestimmten Elementen beeinflusst wird, häufig zur Laufzeit. Daher ist der hier aufgeführte Standardwert manchmal nicht wirksam. So wird IsEnabled false zScrollBar. B. immer dann festgelegt, dass keine Bildlaufleiste unterstützt werden muss. Der Versuch, diesen Wert festzulegen, wird möglicherweise auch durch den von ihnen zurückgegebenen IsEnabledCoreWert außer Kraft gesetzt.

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
Metadateneigenschaften auf true festgelegt	Keine

Siehe auch

• IsEnabledChanged