UIElement.IsEnabled Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość wskazującą, czy ten element jest włączony w interfejsie użytkownika. Jest to właściwość zależności.
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
. Wartość domyślna to true
.
Przykłady
Poniższy przykład przedstawia procedurę obsługi na jednym przycisku, który po wykonaniu zostanie ustawiony IsEnabled false
na innym nazwanym przycisku 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 pamiętać, że ta właściwość ma wpływ na implementacje specyficzne dla IsEnabledCore klasy dla określonych elementów, często w czasie wykonywania. W związku z tym wartość domyślna wymieniona w tym miejscu czasami nie jest skuteczna. Na przykład element ScrollBar będzie zawsze IsEnabled false
, gdy zostanie określony, że nie ma potrzeby obsługi paska przewijania. Próba ustawienia tej wartości będzie również potencjalnie zastępowana przez wartość zwróconą przez IsEnabledCorewartość .
Elementy, które nie są włączone, nie uczestniczą w testowaniu trafienia ani fokusie i dlatego nie będą źródłami zdarzeń wejściowych.
Informacje dotyczące właściwości zależności
Pole identyfikatora | IsEnabledProperty |
Właściwości metadanych ustawione na true |
Brak |