UIElement.IsEnabled Propriedade

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

Valor de Propriedade

true se o elemento estiver ativado; caso contrário, false. O valor predefinido é true.

Exemplos

O exemplo seguinte mostra um handler num botão que, ao ser executado, será ativado IsEnabledfalse noutro botão b1nomeado.

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

Observações

Note-se que esta propriedade é influenciada por implementações específicas de classe de IsEnabledCore em elementos específicos, muitas vezes em tempo de execução. Portanto, o valor padrão aqui listado por vezes não é eficaz. Por exemplo, um ScrollBar será IsEnabledfalse sempre que se determina que não é necessário suportar uma barra de deslocamento. Tentar definir este valor também será potencialmente sobreposto pelo valor devolvido por IsEnabledCore.

Elementos que não estão ativados não participam nos testes de acerto nem no foco e, por isso, não serão fontes de eventos de entrada.

Informação de Propriedade de Dependência

Ver também

• IsEnabledChanged