FocusManager Classe

Definizione

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

Ereditarietà

Object Platform::Object IInspectable FocusManager

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Esempio

Usare TryMoveFocus per attraversare tra gli elementi dell'interfaccia utente usando i tasti di direzione.

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);
   }
}

Commenti

È consigliabile usare gli eventi indirizzati dello stato attivo UIElement anziché gli eventi FocusManager quando possibile.

FocusManager è destinato a scenari avanzati in cui elementi specifici in un'applicazione non ricevono eventi a bolle da un UIElement. Ad esempio, oggetti "overlay" visivi, ad esempio Popup, Descrizione comando o MenuFlyout visualizzati come parte dell'interfaccia utente dell'app, ma sono effettivamente il proprio ambito di messa a fuoco e non fanno parte della gerarchia della struttura ad albero visuale. Nel caso di un popup, questo si verifica quando si imposta IsOpen a livello di codice su true e lo stato attivo si sposta all'interno e all'esterno del popup.

Ecco alcuni markup di base per illustrare l'esempio:

<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>

In questo caso, un popup contiene StackPanel3, che a sua volta contiene Button5. Quando IsOpen è impostato su true e lo stato attivo passa da Button1 a Button5, gli eventi LostFocus e LostFocus si spostano verso l'alto nell'albero visivo (StackPanel1, grid e Page ottengono entrambi questi eventi). Tuttavia, solo StackPanel3 riceve gli eventi GettingFocus e GotFocus successivi che si mettono in bolla da Button5 (Grid e Page non sono in una relazione padre-figlio con Popup).

Un'applicazione può avere più elementi con stato attivo logico (a seconda del numero di ambiti di stato attivo). Tuttavia, solo un elemento nell'applicazione può avere lo stato attivo della tastiera.

Possono essere presenti più elementi con stato attivo logico, ma solo un elemento con stato attivo logico per ambito dello stato attivo. Un elemento con stato attivo logico non ha necessariamente lo stato attivo della tastiera, ma un elemento con lo stato attivo della tastiera ha lo stato attivo logico.

Cronologia delle versioni

Metodi

Eventi

Si applica a

Vedi anche

• Interazioni tramite tastiera
• Spostamento dello stato attivo per tastiera, game pad, telecomando e strumenti di accessibilità
• Spostamento dello stato attivo a livello di codice