Control.IsEnabled Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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"/>
bool
true se o usuário puder interagir com o controle; caso contrário, false.
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.
| Produto | Versões |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |