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

Definition

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dieses Element auf der Benutzeroberfläche (User Interface, UI)user interface (UI) aktiv ist.Gets or sets a value indicating whether this element is enabled in the Benutzeroberfläche (User Interface, UI)user interface (UI). Hierbei handelt es sich um eine Abhängigkeitseigenschaft.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

Eigenschaftswert

true, wenn das Element aktiviert ist, andernfalls false.true if the element is enabled; otherwise, false. Der Standardwert ist truesein.The default value is true.

Beispiele

Das folgende Beispiel zeigt einem Handler auf eine Schaltfläche, die bei der Ausführung IsEnabled false auf einem anderen benannten Schaltfläche 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

Hinweise

Beachten Sie, dass diese Eigenschaft, von Klasse-spezifische Implementierungen von beeinflusst wird IsEnabledCore auf bestimmte Elemente, die häufig zur Laufzeit.Note that this property is influenced by class-specific implementations of IsEnabledCore on particular elements, often at runtime. Aus diesem Grund ist der Standardwert, der hier aufgeführten manchmal nicht wirksam.Therefore, the default value listed here is sometimes not effective. Z. B. eine ScrollBar werden IsEnabled false Wenn bestimmt wird, keine Notwendigkeit zur Unterstützung einer Bildlaufleiste besteht.For instance, a ScrollBar will be IsEnabled false whenever it is determined that there is no need to support a scrollbar. Es wird versucht, zum Festlegen dieses Werts wird möglicherweise auch von den Rückgabewert von überschrieben IsEnabledCore.Attempting to set this value will also potentially be overridden by the value returned by IsEnabledCore.

Elemente, die nicht aktiviert sind keine Teilnahme am Treffertests oder den Fokus und daher nicht Quellen von Eingabeereignissen.Elements that are not enabled do not participate in hit testing or focus and therefore will not be sources of input events.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field IsEnabledProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true KeinerNone

Gilt für:

Siehe auch