Flyout Klasse

Referenz

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 eine einfache Benutzeroberfläche anzeigt, die entweder Informationen darstellt oder eine Benutzerinteraktion erfordert. Im Gegensatz zu einem Dialogfeld kann ein Flyout durch Klicken oder Tippen außerhalb des Fensters, Drücken der Zurück-Taste des Geräts oder Drücken der "Esc"-Taste leicht geschlossen werden.

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

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Flyout.

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

Die WinUI 3-Katalog-App umfasst 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 Codebeispielen, finden Sie unter Flyouts.

Als Wert der Button.Flyout-Eigenschaft wird ein Flyout-Steuerelement (oder MenuFlyout) verwendet. Dies wird normalerweise in XAML als Teil einer UI-Definition der Seite festgelegt. Button ist das einzige Steuerelement, das über eine dedizierte Flyouteigenschaft verfügt. Um ein Flyout anderen Steuerelementen zuzuordnen, verwenden Sie die angefügte FlyoutBase.AttachedFlyout-Eigenschaft . Bei Festlegung auf Button.Flyout wird das Flyout angezeigt, wenn 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 Membern gibt es weitere Member der Basisklasse FlyoutBase , die häufig in typischen Flyoutszenarien verwendet werden:

FlyoutBase.AttachedFlyout: Eine angefügte Eigenschaft, die ein Flyout einem bestimmten Ui-Element ordnet (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-Zuweisung zugeordnet ist. Wenn ja, ruft die Methode ShowAt intern auf, wobei das von Ihnen angegebene FrameworkElement verwendet wird .

Zugriff

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

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

In diesem Beispiel wird gezeigt, wie 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

Flyout()

Initialisiert eine neue instance der Flyout-Klasse.

Eigenschaften

AllowFocusOnInteraction	Ruft einen Wert ab, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer mit ihm interagiert, oder legt diesen fest. (Geerbt von FlyoutBase)
AllowFocusWhenDisabled	Ruft einen Wert ab, der angibt, ob das Steuerelement den Fokus erhalten kann, wenn es deaktiviert ist, oder legt diesen fest. (Geerbt von FlyoutBase)
AreOpenCloseAnimationsEnabled	Ruft einen Wert ab, der angibt, ob Animationen wiedergegeben werden, wenn das Flyout geöffnet oder geschlossen wird, oder legt diesen fest. (Geerbt von FlyoutBase)
Content	Ruft den Inhalt des Flyouts ab oder legt diese fest.
ContentProperty	Ruft den Bezeichner für die Content-Abhängigkeitseigenschaft ab.
Dispatcher	Gibt immer in einer Windows App SDK-App zurück`null`. Verwenden Sie stattdessen DispatcherQueue . (Geerbt von DependencyObject)
DispatcherQueue	Ruft den `DispatcherQueue` ab, dem dieses Objekt zugeordnet ist. Stellt `DispatcherQueue` eine Funktion dar, die auf den `DependencyObject` im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
ElementSoundMode	Ruft einen Wert ab, der die Einstellung des Steuerelements für die Wiedergabe von Sounds angibt, oder legt diesen fest. (Geerbt von FlyoutBase)
FlyoutPresenterStyle	Ruft den Stil ab, der auf den Flyoutinhalt angewendet wird, oder legt diesen 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 öffnen kann. (Geerbt von FlyoutBase)
IsConstrainedToRootBounds	Ruft einen Wert ab, der angibt, ob das Flyout innerhalb der Grenzen des XAML-Stammes angezeigt wird. Diese Eigenschaft gilt immer 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	Ruft einen Wert ab, der angibt, ob der Bereich außerhalb einer Benutzeroberfläche mit Lichtausschluss abgedunkelt ist, oder legt diesen fest. (Geerbt von FlyoutBase)
OverlayInputPassThroughElement	Ruft ein Element ab, das Zeigereingabeereignisse empfangen soll, auch wenn es sich unterhalb der Überlagerung des Flyouts befindet, oder legt es fest. (Geerbt von FlyoutBase)
Placement	Ruft die Standardplatzierung ab, die für das Flyout in Bezug auf das Platzierungsziel verwendet werden soll, oder legt diese fest. (Geerbt von FlyoutBase)
ShouldConstrainToRootBounds	Ruft einen Wert ab, der angibt, ob das Flyout innerhalb der Grenzen des XAML-Stammes angezeigt werden soll, oder legt diesen fest. (Geerbt von FlyoutBase)
ShowMode	Ruft einen Wert ab, der angibt, wie sich ein Flyout verhält, wenn es angezeigt wird, oder legt diesen fest. (Geerbt von FlyoutBase)
SystemBackdrop	Ruft den Systemhintergrund ab, der auf dieses Flyout angewendet werden soll, oder legt diesen fest. Die Kulisse 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	Ruft die XamlRoot ab, in der dieses Flyout angezeigt wird, oder legt diese fest. (Geerbt von FlyoutBase)

Methoden

ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
CreatePresenter()	Initialisiert beim Überschreiben in einer abgeleiteten Klasse ein Steuerelement, um den Flyoutinhalt entsprechend dem abgeleiteten Steuerelement anzuzeigen. Hinweis: Diese Methode verfügt über keine Basisklassenimplementierung und muss in einer abgeleiteten Klasse überschrieben werden. (Geerbt von FlyoutBase)
GetAnimationBaseValue(DependencyProperty)	Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft festgelegt wurde, was in Fällen gilt, 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 aufgerufen, bevor eine Tastenkombination (Accelerator) in Ihrer App verarbeitet wird. Wird immer dann aufgerufen, wenn Anwendungscode oder interne Prozesse ProcessKeyboardAccelerators aufrufen. Überschreiben Sie diese Methode, um die Standardbeschleunigung zu beeinflussen. (Geerbt von FlyoutBase)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (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 Bezug auf das angegebene Element unter Verwendung der angegebenen Optionen an. (Geerbt von FlyoutBase)
ShowAt(FrameworkElement)	Zeigt das Flyout an, das in Bezug auf das angegebene Element platziert wird. (Geerbt von FlyoutBase)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Versucht, eine Tastenkombination (Accelerator) aufzurufen. (Geerbt von FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde. (Geerbt von DependencyObject)

Ereignisse

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:

Freigeben über