UIElement.IsEnabled Propiedad

Definición

Obtiene o establece un valor que indica si este elemento está habilitado en la interfaz de usuario (UI)user interface (UI).Gets or sets a value indicating whether this element is enabled in the interfaz de usuario (UI)user interface (UI). Es una propiedad de dependencia.This is a dependency property.

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; en caso contrario, false.true if the element is enabled; otherwise, false. El valor predeterminado es true.The default value is true.

Ejemplos

En el ejemplo siguiente se muestra un controlador en un botón que, cuando se ejecuta, establecerá IsEnabled false en otro b1de botón con nombre.The following example shows a handler on one button that when executed will set IsEnabled false on another named button 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 se ve afectada por implementaciones específicas de la clase de IsEnabledCore en elementos concretos, a menudo en tiempo de ejecución.Note that this property is influenced by class-specific implementations of IsEnabledCore on particular elements, often at runtime. Por lo tanto, el valor predeterminado que se muestra aquí no es efectivo.Therefore, the default value listed here is sometimes not effective. Por ejemplo, se IsEnabled un ScrollBar false siempre que se determine que no es necesario admitir una barra de desplazamiento.For instance, a ScrollBar will be IsEnabled false whenever it is determined that there is no need to support a scrollbar. El intento de establecer este valor también se reemplazará por el valor devuelto por IsEnabledCore.Attempting to set this value will also potentially be overridden by the value returned by IsEnabledCore.

Los elementos que no están habilitados no participan en la prueba de posicionamiento ni en el foco y, por consiguiente, no son orígenes de eventos de entrada.Elements that are not enabled do not participate in hit testing or focus and therefore will not be sources of input events.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field IsEnabledProperty
Propiedades de metadatos establecidas en trueMetadata properties set to true NoneNone

Se aplica a

Consulte también: