UIElement.IsEnabled Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy ten element jest włączony w interfejs użytkownika (UI)user interface (UI).Gets or sets a value indicating whether this element is enabled in the interfejs użytkownika (UI)user interface (UI). Jest to właściwość zależności.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

Wartość właściwości

true, jeśli element jest włączony; w przeciwnym razie false.true if the element is enabled; otherwise, false. Wartością domyślną jest true.The default value is true.

Przykłady

Poniższy przykład pokazuje procedurę obsługi dla jednego przycisku, który po wykonaniu ustawi IsEnabled false na innym nazwanym przycisku 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

Uwagi

Należy zauważyć, że ta właściwość ma wpływ na implementacje specyficzne dla klasy IsEnabledCore na określonych elementach, często w czasie wykonywania.Note that this property is influenced by class-specific implementations of IsEnabledCore on particular elements, often at runtime. W związku z tym, wartość domyślna wymieniona w tym miejscu nie jest czasami skuteczna.Therefore, the default value listed here is sometimes not effective. Na przykład ScrollBar zostanie IsEnabled false po ustaleniu, że nie ma potrzeby obsługi paska przewijania.For instance, a ScrollBar will be IsEnabled false whenever it is determined that there is no need to support a scrollbar. Próba ustawienia tej wartości może być również przesłaniana przez wartość zwróconą przez IsEnabledCore.Attempting to set this value will also potentially be overridden by the value returned by IsEnabledCore.

Elementy, które nie są włączone, nie uczestniczą w testowaniu trafień ani skupić się, dlatego nie będą źródłami zdarzeń wejściowych.Elements that are not enabled do not participate in hit testing or focus and therefore will not be sources of input events.

Informacje dotyczące właściwości zależnościDependency Property Information

Pole identyfikatoraIdentifier field IsEnabledProperty
Właściwości metadanych ustawione na trueMetadata properties set to true NoneNone

Dotyczy

Zobacz też