CommandBarFlyout Klasse
Definition
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.
Stellt ein spezielles Flyout dar, das ein Layout für AppBarButton und zugehörige Befehlselemente bereitstellt.
Entsprechende WinUI 2-API für UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [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")]
class CommandBarFlyout : FlyoutBase
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[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")]
public class CommandBarFlyout : FlyoutBase
Public Class CommandBarFlyout
Inherits FlyoutBase
<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
commandBarElements
</CommandBarFlyout>
- Vererbung
- Abgeleitet
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10, version 1809 (eingeführt in 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v7.0)
|
Beispiele
Tipp
Weitere Informationen, Entwurfsanweisungen und Codebeispiele finden Sie unter Befehlsleisten-Flyout.
Wenn Sie die WinUI 2-Katalog-App installiert haben, klicken Sie hier, um die App zu öffnen und das CommandBarFlyout in Aktion zu sehen.
Hinweise
Steuerelementstil und -vorlage
Sie können die Standardvorlagen Style und ControlTemplate ändern, um dem Steuerelement ein eindeutiges Aussehen zu verleihen. Informationen zum Ändern des Stils und der Vorlage eines Steuerelements finden Sie unter Formatieren von Steuerelementen. Der Standardstil, die Vorlage und die Ressourcen, die das Aussehen des Steuerelements definieren, sind in der generic.xaml
Datei enthalten. Zu Entwurfszwecken generic.xaml
ist lokal mit der SDK- oder NuGet-Paketinstallation verfügbar.
- * WinUI-Formatvorlagen (empfohlen): Verwenden Sie Microsoft.UI.Xaml.Controls.CommandBarFlyout.
-
Nicht-WinUI-Stile: Integrierte Stile finden Sie unter
%ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml
.
Die Speicherorte können sich unterscheiden, wenn Sie die Installation angepasst haben. Stile und Ressourcen aus verschiedenen Versionen des SDK können unterschiedliche Werte aufweisen.
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-Stile . Leichte Formatierungsressourcen sind ab Windows 10 Version 1607 (SDK 14393) verfügbar.
Konstruktoren
CommandBarFlyout() |
Initialisiert eine neue instance der CommandBarFlyout-Klasse. Entsprechende WinUI 2-API für UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.-ctor (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces). |
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) |
Dispatcher |
Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das 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 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. (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) |
PrimaryCommands |
Ruft die Auflistung der primären Befehlselemente für das CommandBarFlyout ab. Entsprechende WinUI 2-API für UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces). |
SecondaryCommands |
Ruft die Auflistung sekundärer Befehlselemente für das CommandBarFlyout ab. Entsprechende WinUI 2-API für UWP: Microsoft.UI.Xaml.Controls.CommandBarFlyout.SecondaryCommands (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces). |
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) |
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) |