Linguagem

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 "esmaecendo" em rótulos.

Sempre que IsEnabled for alterado, isso aciona o evento IsEnabledChanged . Os controles podem lidar com 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 aciona 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 ou ser focado programaticamente.
  • O controle não aparece em uma sequência de guias (qualquer valor para UIElement.TabIndex é ignorado).
  • Um controle desabilitado ainda está visível para atingir o teste. Ele não pode lidar com eventos de entrada em si mesmo. No entanto, um controle desabilitado ainda pode originar os eventos de entrada e os eventos roteados de entrada podem ser gerados em bolhas para um pai no qual eles podem ser manipulados.

Aplica-se a

Confira também