UIElement.IsEnabled Propiedad

Definición

Obtiene o establece un valor que indica si este elemento está habilitado en la interfaz de usuario (UI). Se trata de 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

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

Ejemplos

En el ejemplo siguiente se muestra un controlador en un botón que cuando se ejecuta establecerá IsEnabledfalse en otro botón con nombre 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

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 se IsEnabledfalse siempre que se determine que no es necesario admitir una barra de desplazamiento. El intento de establecer este valor también se invalidará mediante el valor devuelto por IsEnabledCore.

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

Información de la propiedad dependency

Campo identificador IsEnabledProperty
Propiedades de metadatos establecidas en true Ninguno

Se aplica a

Consulte también