UIElement.IsEnabled Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Obtém ou define um valor que indica se esse elemento está habilitado na interface do usuário (interface do usuário). É uma propriedade de dependência.

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 da propriedade

Boolean

true se o elemento estiver habilitado; caso contrário, false. O valor padrão é true.

Exemplos

O exemplo a seguir mostra um manipulador em um botão que, quando executado, será definido IsEnabled false em outro 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

Comentários

Observe que essa propriedade é influenciada por implementações específicas de classe de IsEnabledCore elementos específicos, muitas vezes em runtime. Portanto, o valor padrão listado aqui às vezes não é eficaz. Por exemplo, um ScrollBar será IsEnabled false sempre que for determinado que não há necessidade de dar suporte a uma barra de rolagem. A tentativa de definir esse valor também será potencialmente substituída pelo valor retornado por IsEnabledCore.

Os elementos que não estão habilitados não participam do teste de clique ou do foco e, portanto, não serão fontes de eventos de entrada.

Informações da propriedade de dependência

Campo identificador	IsEnabledProperty
Propriedades de metadados definidas como true	Nenhum

Confira também

• IsEnabledChanged