UIElement.IsFocused Propriedade

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationCore.dll

Obtém um valor que determina se este elemento tem foco lógico. Isto é 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 de Propriedade

Boolean

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

Exemplos

O exemplo seguinte é um manipulador de código que altera o fundo de um controlo quando este está focado.

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

Outra forma comum de alcançar este mesmo efeito é colocar a Trigger no Style de um controlo; esta 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. Para um exemplo, veja Como: Criar um Efeito de Brilho Exterior.

Observações

O foco lógico pode diferir do foco do teclado se uma aplicação tiver múltiplas divisões de foco, como entre o conteúdo do menu e o restante da aplicação. Neste cenário, o foco do teclado só pode estar num elemento da interface da aplicação, no entanto, certos elementos noutras divisões de foco podem ainda manter o foco lógico. Para mais informações sobre foco lógico, consulte Visão Geral do Foco.

Não defines o foco ao definir esta propriedade (é só leitura). O uso típico desta propriedade é usá-la como propriedade de dependência para um Setter ou EventTrigger. Para definir o foco programaticamente, chame Focus. O foco também pode ser definido pela ação do utilizador ou por implementações de controlo, que possivelmente incluem o comportamento de captura do rato.

Informação de Propriedade de Dependência

Iteme Value
Campo identificador IsFocusedProperty
Propriedades dos metadados definidas como true None

Aplica-se a

Ver também