UIElement.IsEnabled Propriedade

Definição

Obtém ou define um valor que indica se esse elemento está habilitado no UI (interface do usuário)user interface (UI).Gets or sets a value indicating whether this element is enabled in the UI (interface do usuário)user interface (UI). É uma propriedade de dependência.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 da propriedade

true se o elemento estiver habilitado; caso contrário, false.true if the element is enabled; otherwise, false. O valor padrão é true.The default value is true.

Exemplos

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

Comentários

Observe que essa propriedade é influenciada por implementações específicas de classe de IsEnabledCore em determinados elementos, geralmente em tempo de execução.Note that this property is influenced by class-specific implementations of IsEnabledCore on particular elements, often at runtime. Portanto, o valor padrão listado aqui às vezes não é efetivo.Therefore, the default value listed here is sometimes not effective. Por exemplo, um ScrollBar será IsEnabled false sempre que for determinado que não há necessidade de dar suporte a uma barra de rolagem.For instance, a ScrollBar will be IsEnabled false whenever it is determined that there is no need to support a scrollbar. A tentativa de definir esse valor também será potencialmente substituída pelo valor retornado por IsEnabledCore.Attempting to set this value will also potentially be overridden by the value returned by 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.Elements that are not enabled do not participate in hit testing or focus and therefore will not be sources of input events.

Informações de Propriedade de DependênciaDependency Property Information

Campo de identificadorIdentifier field IsEnabledProperty
Propriedades de metadados definidas como trueMetadata properties set to true NenhumNone

Aplica-se a

Veja também