Condividi tramite


Flyout Classe

Definizione

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

Esempio

Suggerimento

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

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.

Controllo riquadro a comparsa

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:

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

Vedi anche