UIElement.IsEnabled UIElement.IsEnabled UIElement.IsEnabled UIElement.IsEnabled Property

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

El ejemplo siguiente muestra un controlador en un botón que cuando establece ejecuta IsEnabled false en otro botón con nombre b1.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 influida por las implementaciones específicas de la clase de IsEnabledCore en determinados elementos, 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 enumerado aquí a veces no es eficaz.Therefore, the default value listed here is sometimes not effective. Por ejemplo, un ScrollBar será IsEnabled false cada vez que se determina que no es necesario para 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. Al intentar establecer este valor también potencialmente serán reemplazado 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 o enfoque y, por tanto, no será 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
Establecen las propiedades de metadatos en trueMetadata properties set to true NoneNone

Se aplica a

Consulte también: