UIElement.IsFocused Propriedade

Definição

Obtém um valor que determina se esse elemento tem foco lógico. É uma propriedade de dependência.

C#
public bool IsFocused { get; }

Valor da propriedade

Boolean

true se esse elemento tiver o foco lógico; caso contrário, false.

Exemplos

O exemplo a seguir é um manipulador de código que altera a tela de fundo de um controle quando ele está focado.

C#
private void setColors(object sender, RoutedEventArgs e)
{
    if (myTextBox.IsFocused) myTextBox.Foreground = Brushes.Brown;
}

Outra maneira comum de obter esse mesmo efeito é colocar um Trigger no Style controle; essa abordagem não requer lidar com eventos específicos com code-behind e permite aos designers maior acesso à natureza interativa e gráfica da interface do usuário. Para obter um exemplo, consulte Como criar um efeito de brilho externo.

Comentários

O foco lógico poderá ser diferente do foco do teclado se um aplicativo tiver várias divisões de foco, como entre o conteúdo do menu e o restante do aplicativo. Nesse cenário, o foco do teclado só pode estar em um elemento da interface do usuário do aplicativo, no entanto, determinados elementos em outras divisões de foco ainda podem manter o foco lógico. Para obter mais informações sobre o foco lógico, consulte Visão Geral do Foco.

Você não define o foco definindo essa propriedade (ela é somente leitura). O uso típico dessa propriedade é usá-la como uma propriedade de dependência para um Setter ou EventTrigger. Para definir o foco programaticamente, chame Focus. O foco também pode ser definido por ação do usuário ou por implementações de controle, que possivelmente incluem o comportamento de captura do mouse.

Informações da propriedade de dependência

Campo identificador IsFocusedProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Produto Versões
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7

Confira também