Compartilhar via


Control.IsEnabled Propriedade

Definição

Obtém ou define um valor que indica se o usuário pode interagir com o controle.

public:
 property bool IsEnabled { bool get(); void set(bool value); };
bool IsEnabled();

void IsEnabled(bool value);
public bool IsEnabled { get; set; }
var boolean = control.isEnabled;
control.isEnabled = boolean;
Public Property IsEnabled As Boolean
<control IsEnabled="bool"/>

Valor da propriedade

Boolean

bool

true se o usuário puder interagir com o controle; caso contrário, false.

Comentários

Muitos controles têm estados visuais predefinidos que são invocados para IsEnabled =false, como texto "esmaecido" em rótulos.

Sempre que IsEnabled for alterado, isso disparará o evento IsEnabledChanged . Os controles podem manipular esse evento para alterar os estados visuais. O evento tem dados dependencyPropertyChangedEventArgs , para que você possa determinar os valores antigos e novos sem precisar usar seus próprios sinalizadores.

Um controle herda a propriedade IsEnabled de seu controle pai. Por exemplo, se um controle que contém um botão tiver IsEnabled definido como false, a propriedade IsEnabled do botão também será falsa. Quando a propriedade do pai é alterada, isso dispara IsEnabledChanged para cada controle em que o valor é alterado devido ao valor herdado.

Como a lógica de controle se comporta quando desabilitada é potencialmente diferente para cada controle. No entanto, esses comportamentos resultarão em todos os controles quando IsEnabled =false:

  • O controle não pode receber o foco do teclado nem se concentrar programaticamente.
  • O controle não aparece em uma sequência de tabulação (qualquer valor para TabIndex é ignorado).
  • Um controle desabilitado ainda está visível para testes de clique. Ele não pode manipular nenhum evento de entrada em si mesmo. No entanto, um controle desabilitado ainda pode originar os eventos de entrada, e os eventos roteados de entrada podem bolhas para um pai onde eles podem ser manipulados.

Aplica-se a

Confira também