UIElement.IsEnabled Propiedad

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationCore.dll

Obtiene o establece un valor que indica si este elemento está habilitado en la interfaz de usuario (UI). Es una propiedad de dependencia.

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 propiedad

Boolean

true si el elemento está habilitado; en caso contrario, false. El valor predeterminado es true.

Ejemplos

En el ejemplo siguiente se muestra un controlador en un botón que cuando se ejecuta se establecerá IsEnabled false en otro botón b1con nombre .

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

Comentarios

Tenga en cuenta que esta propiedad está influenciada por implementaciones específicas de clase de IsEnabledCore en elementos concretos, a menudo en tiempo de ejecución. Por lo tanto, el valor predeterminado que se muestra aquí a veces no es efectivo. Por ejemplo, un ScrollBar elemento será IsEnabled false siempre que se determine que no es necesario admitir una barra de desplazamiento. Si intenta establecer este valor, también se invalidará el valor devuelto por IsEnabledCore.

Los elementos que no están habilitados no participan en las pruebas de posicionamiento o el foco y, por tanto, no serán orígenes de eventos de entrada.

Información sobre propiedades de dependencia

Campo identificador	IsEnabledProperty
Propiedades de metadatos establecidas en true	Ninguno

Consulte también

• IsEnabledChanged