FocusManager Classe

Definição

public ref class FocusManager sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FocusManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FocusManager

Public NotInheritable Class FocusManager

Herança

Object Platform::Object IInspectable FocusManager

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Exemplos

Use TryMoveFocus para percorrer os elementos da interface do usuário usando as teclas de direção.

private void Page_KeyUp(object sender, KeyRoutedEventArgs e)
{
   if (e.Key == Windows.System.VirtualKey.Up)
   {
      // Mimic Shift+Tab when user hits up arrow key.
      FocusManager.TryMoveFocus(FocusNavigationDirection.Previous);
   }
   else if (e.Key == Windows.System.VirtualKey.Down)
   {
      // Mimic Tab when user hits down arrow key.
      FocusManager.TryMoveFocus(FocusNavigationDirection.Next);
   }
}

Comentários

É recomendável usar os eventos roteados de foco UIElement em vez de eventos FocusManager sempre que possível.

O FocusManager destina-se a cenários avançados em que elementos específicos em um aplicativo não recebem eventos bolhas de um UIElement. Por exemplo, objetos visuais de "sobreposição", como Pop-up, Dica de Ferramenta ou MenuFlyout , que aparecem como parte da interface do usuário do aplicativo, mas na verdade são seu próprio escopo de foco e não fazem parte da hierarquia de árvore visual. No caso de um pop-up, isso ocorre quando você define programaticamente IsOpen como true e o foco entra e sai do pop-up.

Aqui está uma marcação básica para ilustrar o exemplo:

<Page …>
    <Grid …>
        <Popup …>
            <StackPanel Name="StackPanel3" …>
                <TextBlock Text="StackPanel3" />
                <Button Content="Button5" …/>
            </StackPanel>
        </Popup>
        <TextBlock Text="Grid" … />
        <StackPanel Name="StackPanel1" …>
            <TextBlock Text="StackPanel1" …/>
            <Button Content="Button1" …/>
            <Button Content="Button2" … />
        </StackPanel>
        <StackPanel Name="StackPanel2" …>
            <TextBlock Text="StackPanel2" …/>
            <Button Content="Button3" … />
            <Button Content="Button4" … />
        </StackPanel>
    </Grid>
</Page>

Nesse caso, um pop-up contém StackPanel3, que, por sua vez, contém Button5. Quando IsOpen é definido como true e o foco passa de Button1 para Button5, os eventos LosingFocus e LostFocus aparecem na árvore visual (StackPanel1, Grid e Page obtêm esses dois eventos). No entanto, somente StackPanel3 recebe os eventos GettingFocus e GotFocus subsequentes que surgem de Button5 (Grade e Página não, pois não estão em uma relação pai-filho com Popup).

Um aplicativo pode ter vários elementos com foco lógico (dependendo do número de escopos de foco). No entanto, apenas um elemento no aplicativo pode ter o foco do teclado.

Pode haver vários elementos com foco lógico, mas apenas um elemento com foco lógico por escopo de foco. Um elemento com foco lógico não tem necessariamente o foco do teclado, mas um elemento com foco no teclado tem foco lógico.

Histórico de versão

Métodos

Eventos

Aplica-se a

Confira também

• Interações por teclado
• Navegação por foco para teclado, gamepad, controle remoto e ferramentas de acessibilidade
• Navegação por foco programática