Flyout Classe

Definizione

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Flyout : FlyoutBase

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Flyout : FlyoutBase

Public Class Flyout
Inherits FlyoutBase

<Flyout>
    singleUIElement
</Flyout>

Ereditarietà

Object IInspectable DependencyObject FlyoutBase Flyout

Attributi

ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Esempio

L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli e delle funzionalità di WinUI 3. Scaricare l'app da Microsoft Store od ottenere il codice sorgente su GitHub

Commenti

Un riquadro a comparsa visualizza un messaggio che richiede l'interazione dell'utente.

Usa un controllo riquadro a comparsa per raccogliere informazioni, per visualizzare altre informazioni o per avvisi e conferme. A differenza di una finestra di dialogo, un riquadro a comparsa non crea una finestra separata e non blocca l'interazione dell'utente. Per visualizzare un menu di voci, usare un menuFlyout . Per altre info, inclusi esempi di codice e XAML, vedi Riquadri a comparsa.

Un controllo Riquadro a comparsa (o MenuFlyout) viene utilizzato come valore della proprietà Button.Flyout . Questa impostazione viene in genere impostata in XAML come parte di una definizione dell'interfaccia utente della pagina. Button è l'unico controllo con una proprietà Flyout dedicata. Per associare un riquadro a comparsa ad altri controlli, utilizzare la proprietà associata FlyoutBase.AttachedFlyout . Se impostato su Button.Flyout, il riquadro a comparsa viene visualizzato quando il pulsante viene toccato o richiamato in altro modo. Quando un riquadro a comparsa viene assegnato ad altri elementi dell'interfaccia utente usando FlyoutBase.AttachedFlyout, è necessario chiamare il metodo ShowAt o il metodo Statico ShowAttachedFlyout per visualizzare il riquadro a comparsa.

Oltre ai membri elencati in questo argomento di riferimento, sono presenti altri membri della classe base FlyoutBase che vengono spesso usati in scenari tipici del riquadro a comparsa:

• FlyoutBase.AttachedFlyout: una proprietà associata che associa un riquadro a comparsa a un particolare elemento dell'interfaccia utente (può essere qualsiasi classe derivata FrameworkElement ).
• ShowAttachedFlyout: metodo statico che può determinare se un riquadro a comparsa è già associato a un elemento dell'interfaccia utente tramite un'assegnazione FlyoutBase.AttachedFlyout . In tal caso, il metodo chiama internamente ShowAt , usando FrameworkElement specificato.

Accessibility

Se si usa un riquadro a comparsa senza contenuto attivabile, ad esempio con solo testo, come illustrato di seguito, è necessario eseguire alcuni passaggi aggiuntivi per assicurarsi che il contenuto sia accessibile. In particolare, è necessario assicurarsi che Windows Assistente vocale o altre utilità per la lettura dello schermo possano leggere il contenuto del riquadro a comparsa.

Per impostazione predefinita, sono disponibili proprietà impostate in FlyoutPresenter che impediscono la ricezione dello stato attivo. Questo è il comportamento desiderato quando il contenuto all'interno del riquadro a comparsa può ricevere lo stato attivo. Tuttavia, se il contenuto all'interno del riquadro a comparsa non riesce a ricevere lo stato attivo, è consigliabile eseguire l'aggiornamento a FlyoutPresenterStyle per consentire al FlyoutPresenter di ricevere lo stato attivo. A tale scopo, impostare UIElement.IsTabStop su true e TabNavigation su Cycle nello stile del relatore a comparsa.

Questo esempio mostra come consentire a FlyoutPresenter di ricevere lo stato attivo in modo che il contenuto sia accessibile.

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Button VerticalAlignment="Center" HorizontalAlignment="Center"
            Content="Open flyout">
        <Button.Flyout>
            <Flyout>
                <Flyout.FlyoutPresenterStyle>
                    <Style TargetType="FlyoutPresenter">
                        <Setter Property="ScrollViewer.HorizontalScrollMode" Value="Disabled"/>
                        <Setter Property="ScrollViewer.HorizontalScrollBarVisibility" Value="Disabled"/>
                        <Setter Property="IsTabStop" Value="True"/>
                        <Setter Property="TabNavigation" Value="Cycle"/>
                    </Style>
                </Flyout.FlyoutPresenterStyle>
                <TextBlock TextWrapping="Wrap" Text="This is some text in a flyout."/>
            </Flyout>
        </Button.Flyout>
    </Button>
</Grid>

Vedi anche

• FlyoutBase
• FlyoutPresenter
• Flyout
• MenuFlyout
• riquadri a comparsa
• Finestre di dialogo v. riquadri a comparsa
• Panoramica delle proprietà associate
• Esempio di Comando (Windows 10)