Partilhar via


UIElement.IsFocused Propriedade

Definição

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

public:
 property bool IsFocused { bool get(); };
public bool IsFocused { get; }
member this.IsFocused : bool
Public ReadOnly Property IsFocused As Boolean

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.

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

Confira também