Freigeben über


CommandBarFlyout Klasse

Definition

Stellt ein spezielles Flyout dar, das das Layout für AppBarButton-, AppBarToggleButton- und AppBarSeparator-Steuerelemente bereitstellt.

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=7)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
class CommandBarFlyout : FlyoutBase
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class CommandBarFlyout : FlyoutBase
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=7)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
public class CommandBarFlyout : FlyoutBase
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class CommandBarFlyout : FlyoutBase
Public Class CommandBarFlyout
Inherits FlyoutBase
<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
  commandBarElements
</CommandBarFlyout>
Vererbung
Object IInspectable DependencyObject FlyoutBase CommandBarFlyout
Abgeleitet
Attribute

Beispiele

Tipp

Weitere Informationen, Entwurfsleitfäden und Codebeispiele finden Sie unter Befehlsleisten-Flyout.

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

Sie können einem CommandBarFlyout weitere Steuerelemente hinzufügen, indem Sie sie in einen AppBarElementContainer umschließen. Dazu gehören Steuerelemente wie DropDownButton oder SplitButton oder Container wie StackPanel für komplexere Benutzeroberfläche.

Steuerelementstil und -vorlage

Sie können den Standardstil und die ControlTemplate ändern, um dem Steuerelement ein eindeutiges Erscheinungsbild zu verleihen. Informationen zum Ändern des Stils und der Vorlage eines Steuerelements finden Sie unter XAML-Formatvorlagen. Der Standardstil, die Vorlage und die Ressourcen, die das Erscheinungsbild des Steuerelements definieren, sind in der generic.xaml Datei enthalten. Zu Entwurfszwecken generic.xaml wird mit dem Windows App SDK NuGet-Paket installiert. Standardmäßig ist der Speicherort \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml. Stile und Ressourcen aus verschiedenen Versionen des SDK haben möglicherweise unterschiedliche Werte.

XAML enthält auch Ressourcen, mit denen Sie die Farben eines Steuerelements in verschiedenen visuellen Zuständen ändern können, ohne die Steuerelementvorlage zu ändern. Das Ändern dieser Ressourcen wird bevorzugt, um Eigenschaften wie Hintergrund und Vordergrund festzulegen. Weitere Informationen finden Sie im Abschnitt Leichtes Formatieren des Artikels XAML-Formatvorlagen .

Konstruktoren

CommandBarFlyout()

Initialisiert eine neue instance der CommandBarFlyout-Klasse.

Eigenschaften

AllowFocusOnInteraction

Ruft einen Wert ab, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer mit dem Element 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)
AlwaysExpanded

Ruft einen Wert ab, der angibt, ob commandBarFlyout immer im Erweiterten Zustand bleiben soll, und verhindert, dass der Benutzer in den Reduzierten Zustand wechselt, oder legt diesen fest. Der Standardwert ist „false“.

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

Gibt immer in einer Windows App SDK-App zurücknull. 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)
InputDevicePrefersPrimaryCommands

Ruft einen Wert ab, der angibt, ob das Zum Öffnen des Flyouts verwendete Eingabegerät 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 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 hellem Schließen 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 dieses 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)
PrimaryCommands

Ruft die Auflistung der primären Befehlselemente für commandBarFlyout ab.

SecondaryCommands

Ruft die Auflistung sekundärer Befehlselemente für commandBarFlyout ab.

ShouldConstrainToRootBounds

Ruft einen Wert ab, der angibt, ob das Flyout innerhalb der Grenzen des XAML-Stamms 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. 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

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 eingerichtet wurde, der 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, kurz bevor eine Tastenkombination (Accelerator) in Ihrer App verarbeitet wird. Wird immer 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 an, das unter Verwendung der angegebenen Optionen in Bezug auf das angegebene Element platziert wird.

(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 (Zugriffstaste) aufzurufen.

(Geerbt von FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert 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:

Weitere Informationen