Flyout Klasse

Definition

Namespace:: Microsoft.UI.Xaml.Controls

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt ein Steuerelement dar, das einfache UI-Elemente anzeigt, die entweder Informationen sind oder eine Benutzerinteraktion erfordert. Im Gegensatz zu einem Dialogfeld kann ein Flyout leicht geschlossen werden, indem er darauf klickt oder darauf tippt, die Zurück-Taste des Geräts drückt oder die ESC-TASTE drückt.

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

Vererbung: Object IInspectable DependencyObject FlyoutBase Flyout

Attribute: ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Tip

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Flyout.

Öffnen Sie die WinUI 3 Gallery-App, und sehen Sie das Flyout in Aktion.

Die WinUI 3 Gallery-App enthält interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Laden Sie die App aus dem Microsoft Store herunter, oder rufen Sie den Quellcode auf GitHub ab

Hinweise

Ein Flyout zeigt eine Meldung an, die eine Benutzerinteraktion erfordert.

Verwenden Sie ein Flyout-Steuerelement zum Sammeln von Informationen, zum Anzeigen weiterer Informationen oder für Warnungen und Bestätigungen. Im Gegensatz zu einem Dialogfeld erstellt ein Flyout kein separates Fenster und blockiert keine andere Benutzerinteraktion. Um ein Menü mit Elementen anzuzeigen, verwenden Sie stattdessen ein MenuFlyout . Weitere Informationen, einschließlich XAML- und Codebeispiele, finden Sie unter Flyouts.

Ein Flyout-Steuerelement (oder MenuFlyout) wird als Wert der Button.Flyout-Eigenschaft verwendet. Dies wird in der Regel als Teil einer UI-Definition der Seite in XAML festgelegt. Schaltfläche ist das einzige Steuerelement, das über eine dedizierte Flyout-Eigenschaft verfügt. Um ein Flyout anderen Steuerelementen zuzuordnen, verwenden Sie die angefügte FlyoutBase.AttachedFlyout-Eigenschaft . Wenn sie als Button.Flyout festgelegt ist, wird das Flyout angezeigt, wenn auf die Schaltfläche getippt oder anderweitig aufgerufen wird. Wenn ein Flyout anderen UI-Elementen mithilfe von FlyoutBase.AttachedFlyout zugewiesen wird, müssen Sie entweder die ShowAt-Methode oder die statische ShowAttachedFlyout-Methode aufrufen, um das Flyout anzuzeigen.

Zusätzlich zu den in diesem Referenzthema aufgeführten Mitgliedern gibt es weitere Member der Basisklasse FlyoutBase, die häufig in typischen Flyoutszenarien verwendet werden:

FlyoutBase.AttachedFlyout: eine angefügte Eigenschaft, die einem Flyout ein bestimmtes UI-Element zuordnet (dies kann eine beliebige von FrameworkElement abgeleitete Klasse sein).
ShowAttachedFlyout: eine statische Methode, die bestimmen kann, ob ein Flyout bereits einem UI-Element über eine FlyoutBase.AttachedFlyout-Zuordnung zugeordnet ist. Wenn ja, ruft die Methode ShowAt intern mit dem von Ihnen angegebenen FrameworkElement auf.

Accessibility

Wenn Sie beispielsweise ein Flyout ohne fokussierbaren Inhalt verwenden, z. B. mit nur Text, wie hier gezeigt, sollten Sie einige zusätzliche Schritte ausführen, um sicherzustellen, dass Ihre Inhalte barrierefrei sind. Insbesondere müssen Sie sicherstellen, dass Windows Sprachausgabe oder andere Bildschirmsprachausgaben den Inhalt des Flyouts lesen können.

Standardmäßig sind Eigenschaften für flyoutPresenter festgelegt, die verhindern, dass der Fokus empfangen wird. Dies ist das gewünschte Verhalten, wenn Inhalte im Flyout den Fokus erhalten können. Wenn der Inhalt im Flyout jedoch keinen Fokus erhalten kann, sollten Sie auf flyoutPresenterStyle aktualisieren, damit flyoutPresenterStyle stattdessen den Fokus erhält. Legen Sie dazu "UIElement.IsTabStop " auf "true " und "TabNavigation " auf " Cycle " im Flyout-Referentenformat fest.

In diesem Beispiel wird gezeigt, wie der FlyoutPresenter den Fokus erhält, damit auf den Inhalt zugegriffen werden kann.

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

Konstruktoren

Name	Beschreibung
Flyout()	Initialisiert eine neue Instanz der Flyout-Klasse .

Eigenschaften

Name	Beschreibung
AllowFocusOnInteraction	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer damit interagiert. (Geerbt von FlyoutBase)
AllowFocusWhenDisabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement den Fokus erhalten kann, wenn es deaktiviert ist. (Geerbt von FlyoutBase)
AreOpenCloseAnimationsEnabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Animationen wiedergegeben werden, wenn das Flyout geöffnet oder geschlossen wird. (Geerbt von FlyoutBase)
Content	Dient zum Abrufen oder Festlegen des Inhalts des Flyouts.
ContentProperty	Ruft den Bezeichner für die Inhaltsabhängigkeitseigenschaft ab.
Dispatcher	Gibt immer in einer Windows App SDK-App zurück `null` . Verwenden Sie stattdessen DispatcherQueue . (Geerbt von DependencyObject)
DispatcherQueue	Ruft ab `DispatcherQueue` , dem dieses Objekt zugeordnet ist. Dies `DispatcherQueue` stellt eine Einrichtung dar, die auf den `DependencyObject` UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
ElementSoundMode	Dient zum Abrufen oder Festlegen eines Werts, der die Einstellung des Steuerelements für die Wiedergabe von Sounds angibt. (Geerbt von FlyoutBase)
FlyoutPresenterStyle	Ruft die Formatvorlage ab, die auf den Flyoutinhalt angewendet wird, oder legt diese fest.
FlyoutPresenterStyleProperty	Ruft den Bezeichner für die FlyoutPresenterStyle-Abhängigkeitseigenschaft ab.
InputDevicePrefersPrimaryCommands	Ruft einen Wert ab, der angibt, ob das Eingabegerät zum Öffnen des Flyouts die sekundären Befehle nicht einfach öffnet. (Geerbt von FlyoutBase)
IsConstrainedToRootBounds	Ruft einen Wert ab, der angibt, ob das Flyout innerhalb der Grenzen des XAML-Stamms angezeigt wird. Diese Eigenschaft ist immer true für Windows App SDK Apps. (Geerbt von FlyoutBase)
IsOpen	Ruft einen Wert ab, der angibt, ob das Flyout geöffnet ist. (Geerbt von FlyoutBase)
LightDismissOverlayMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Bereich außerhalb einer Benutzeroberfläche mit hellem Ausblenden abgedunkelt ist. (Geerbt von FlyoutBase)
OverlayInputPassThroughElement	Dient zum Abrufen oder Festlegen eines Elements, das Zeigereingabeereignisse auch dann empfangen soll, wenn es sich unterhalb der Überlagerung des Flyouts befindet. (Geerbt von FlyoutBase)
Placement	Dient zum Abrufen oder Festlegen der Standardplatzierung, die für das Flyout verwendet werden soll, im Verhältnis zum Platzierungsziel. (Geerbt von FlyoutBase)
ShouldConstrainToRootBounds	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Flyout innerhalb der Grenzen des XAML-Stamms angezeigt werden soll. (Geerbt von FlyoutBase)
ShowMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie sich ein Flyout verhält, wenn angezeigt wird. (Geerbt von FlyoutBase)
SystemBackdrop	Ruft den Systemhintergrund ab, der auf dieses Flyout angewendet werden soll, oder legt diesen fest. Der Hintergrund wird hinter dem Flyoutinhalt gerendert. (Geerbt von FlyoutBase)
Target	Ruft das Element ab, das als Platzierungsziel des Flyouts verwendet werden soll. (Geerbt von FlyoutBase)
XamlRoot	Dient zum Abrufen oder Festlegen des XamlRoot-Steuerelements, in dem dieses Flyout angezeigt wird. (Geerbt von FlyoutBase)

Methoden

Name	Beschreibung
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
CreatePresenter()	Wenn ein Steuerelement in einer abgeleiteten Klasse überschrieben wird, wird ein Steuerelement initialisiert, um den Flyoutinhalt entsprechend dem abgeleiteten Steuerelement anzuzeigen. Hinweis: Diese Methode hat keine Basisklassenimplementierung und muss in einer abgeleiteten Klasse überschrieben werden. (Geerbt von FlyoutBase)
GetAnimationBaseValue(DependencyProperty)	Gibt einen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
Hide()	Schließt das Flyout. (Geerbt von FlyoutBase)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	Wird direkt vor der Verarbeitung einer Tastenkombination (Tastenkombination) in Ihrer App aufgerufen. Wird immer aufgerufen, wenn Anwendungscode oder interne Prozesse ProcessKeyboardAccelerators aufrufen. Überschreiben Sie diese Methode, um die Standardmäßige Zugriffstastenbehandlung zu beeinflussen. (Geerbt von FlyoutBase)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt wird. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
ShowAt(DependencyObject, FlyoutShowOptions)	Zeigt das Flyout in Relation zum angegebenen Element mithilfe der angegebenen Optionen an. (Geerbt von FlyoutBase)
ShowAt(FrameworkElement)	Zeigt das Flyout in Relation zum angegebenen Element an. (Geerbt von FlyoutBase)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Versucht, eine Tastenkombination (Zugriffstaste) aufzurufen. (Geerbt von FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject)

Ereignisse

Name	Beschreibung
Closed	Tritt auf, wenn das Flyout ausgeblendet ist. (Geerbt von FlyoutBase)
Closing	Tritt auf, wenn das Flyout ausgeblendet wird. (Geerbt von FlyoutBase)
Opened	Tritt auf, wenn das Flyout angezeigt wird. (Geerbt von FlyoutBase)
Opening	Tritt auf, bevor das Flyout angezeigt wird. (Geerbt von FlyoutBase)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?