Flyout Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.UI.Xaml.Controls

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta un controllo che visualizza un'interfaccia utente leggera che sia informazioni o richiede l'interazione dell'utente. A differenza di un dialogo, un riquadro a comparsa può essere leggero ignorato facendo clic o toccando al di fuori di esso, premendo il pulsante Indietro del dispositivo o premendo il tasto "ESC".

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

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Riquadro a comparsa.

Aprire l'app Raccolta WinUI 3 e visualizzare il riquadro a comparsa in azione.

L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità winUI 3. Ottenere l'app da Microsoft Store o ottenere il codice sorgente in 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. Diversamente da una finestra di dialogo, un riquadro a comparsa non crea una finestra separata e non blocca l'interazione con altri utenti. Per visualizzare un menu di voci, usare invece 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, esistono altri membri della classe di base FlyoutBase che vengono spesso usati nei tipici scenari 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 di FrameworkElement ).
ShowAttachedFlyout: metodo statico che consente di 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.

Accessibilità

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 l'Assistente vocale di Windows o altre utilità per la lettura dello schermo possa leggere il contenuto del riquadro a comparsa.

Controllo riquadro a comparsa con contenuto di testo

Per impostazione predefinita, in FlyoutPresenter sono impostate proprietà 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 può ricevere lo stato attivo, è necessario 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>

Costruttori

Flyout()

Inizializza una nuova istanza della classe Flyout .

Proprietà

AllowFocusOnInteraction	Ottiene o imposta un valore che indica se l'elemento ottiene automaticamente lo stato attivo quando l'utente interagisce con esso. (Ereditato da FlyoutBase)
AllowFocusWhenDisabled	Ottiene o imposta un valore che specifica se il controllo può ricevere lo stato attivo quando è disabilitato. (Ereditato da FlyoutBase)
AreOpenCloseAnimationsEnabled	Ottiene o imposta un valore che indica se le animazioni vengono riprodotte quando il riquadro a comparsa viene aperto o chiuso. (Ereditato da FlyoutBase)
Content	Ottiene o imposta il contenuto del riquadro a comparsa.
ContentProperty	Ottiene l'identificatore per la proprietà di dipendenza Content .
Dispatcher	Restituisce `null` sempre in un'app SDK per app di Windows. Usare invece DispatcherQueue . (Ereditato da DependencyObject)
DispatcherQueue	Ottiene l'oggetto a cui è associato l'oggetto `DispatcherQueue` . `DispatcherQueue` Rappresenta una funzionalità che può accedere a nel thread dell'interfaccia `DependencyObject` utente anche se il codice viene avviato da un thread non dell'interfaccia utente. (Ereditato da DependencyObject)
ElementSoundMode	Ottiene o imposta un valore che specifica la preferenza del controllo per la riproduzione di suoni. (Ereditato da FlyoutBase)
FlyoutPresenterStyle	Ottiene o imposta lo stile applicato al contenuto del riquadro a comparsa .
FlyoutPresenterStyleProperty	Ottiene l'identificatore per la proprietà di dipendenza FlyoutPresenterStyle .
InputDevicePrefersPrimaryCommands	Ottiene un valore che indica se il dispositivo di input utilizzato per aprire il riquadro a comparsa non apre facilmente i comandi secondari. (Ereditato da FlyoutBase)
IsConstrainedToRootBounds	Ottiene un valore che indica se il riquadro a comparsa viene visualizzato all'interno dei limiti della radice XAML. Questa proprietà è sempre true per le app di SDK per app di Windows. (Ereditato da FlyoutBase)
IsOpen	Ottiene un valore che indica se il riquadro a comparsa è aperto. (Ereditato da FlyoutBase)
LightDismissOverlayMode	Ottiene o imposta un valore che specifica se l'area esterna a un'interfaccia utente di chiusura della luce viene oscurata. (Ereditato da FlyoutBase)
OverlayInputPassThroughElement	Ottiene o imposta un elemento che deve ricevere eventi di input del puntatore anche quando si trova sotto la sovrimpressione del riquadro a comparsa. (Ereditato da FlyoutBase)
Placement	Ottiene o imposta il posizionamento predefinito da utilizzare per il riquadro a comparsa, in relazione alla destinazione di posizionamento. (Ereditato da FlyoutBase)
ShouldConstrainToRootBounds	Ottiene o imposta un valore che indica se il riquadro a comparsa deve essere visualizzato all'interno dei limiti della radice XAML. (Ereditato da FlyoutBase)
ShowMode	Ottiene o imposta un valore che indica il comportamento di un riquadro a comparsa quando viene visualizzato. (Ereditato da FlyoutBase)
SystemBackdrop	Ottiene o imposta lo sfondo del sistema da applicare a questo riquadro a comparsa. Il rendering dello sfondo viene eseguito dietro il contenuto del riquadro a comparsa. (Ereditato da FlyoutBase)
Target	Ottiene l'elemento da utilizzare come destinazione di posizionamento del riquadro a comparsa. (Ereditato da FlyoutBase)
XamlRoot	Ottiene o imposta l'oggetto XamlRoot in cui viene visualizzato questo riquadro a comparsa. (Ereditato da FlyoutBase)

Metodi

ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject)
CreatePresenter()	Quando ne viene eseguito l'override in una classe derivata, inizializza un controllo per visualizzare il contenuto del riquadro a comparsa come appropriato per il controllo derivato. Nota: questo metodo non ha implementazione della classe di base e deve essere sottoposto a override in una classe derivata. (Ereditato da FlyoutBase)
GetAnimationBaseValue(DependencyProperty)	Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva. (Ereditato da DependencyObject)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza da dependencyObject. (Ereditato da DependencyObject)
Hide()	Chiude il riquadro a comparsa. (Ereditato da FlyoutBase)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	Chiamato subito prima dell'elaborazione di un tasto di scelta rapida (acceleratore) nell'app. Richiamato ogni volta che il codice dell'applicazione o i processi interni chiamano ProcessKeyboardAccelerators. Eseguire l'override di questo metodo per influenzare la gestione dell'acceleratore predefinita. (Ereditato da FlyoutBase)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se è impostato un valore locale. (Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una funzione di notifica per l'ascolto delle modifiche apportate a una dipendenza specifica in questa istanza di DependencyObject . (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza su dependencyObject. (Ereditato da DependencyObject)
ShowAt(DependencyObject, FlyoutShowOptions)	Mostra il riquadro a comparsa posizionato in relazione all'elemento specificato utilizzando le opzioni specificate. (Ereditato da FlyoutBase)
ShowAt(FrameworkElement)	Mostra il riquadro a comparsa posizionato in relazione all'elemento specificato. (Ereditato da FlyoutBase)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Tenta di richiamare una scelta rapida da tastiera (acceleratore). (Ereditato da FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject)

Eventi

Closed	Si verifica quando il riquadro a comparsa è nascosto. (Ereditato da FlyoutBase)
Closing	Si verifica quando il riquadro a comparsa inizia a essere nascosto. (Ereditato da FlyoutBase)
Opened	Si verifica quando viene visualizzato il riquadro a comparsa. (Ereditato da FlyoutBase)
Opening	Si verifica prima che venga visualizzato il riquadro a comparsa. (Ereditato da FlyoutBase)

Si applica a