CommandBarFlyout Classe

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Représente un menu volant spécialisé qui fournit une disposition pour les contrôles AppBarButton, AppBarToggleButton et AppBarSeparator .

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

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

Héritage

Object IInspectable DependencyObject FlyoutBase CommandBarFlyout

Dérivé

Microsoft.UI.Xaml.Controls.TextCommandBarFlyout

Attributs

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Menu volant de la barre de commandes.

Ouvrez l’application Galerie WinUI 3 et voyez commandBarFlyout en action.

L’application WinUI 3 Gallery comprend des exemples interactifs de la plupart des contrôles et des fonctionnalités WinUI 3. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

Remarques

Vous pouvez ajouter d’autres contrôles à un CommandBarFlyout en les encapsulant dans un AppBarElementContainer. Cela inclut des contrôles tels que DropDownButton ou SplitButton, ou des conteneurs comme StackPanel pour une interface utilisateur plus complexe.

Modèle et style de contrôle

Vous pouvez modifier le Style par défaut et ControlTemplate pour donner au contrôle une apparence unique. Pour plus d’informations sur la modification du style et du modèle d’un contrôle, consultez Styles XAML. Le style, le modèle et les ressources par défaut qui définissent l’apparence du contrôle sont inclus dans le generic.xaml fichier. À des fins de conception, generic.xaml est installé avec le package NuGet SDK d'application Windows. Par défaut, l'emplacement est \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml. Les styles et les ressources de différentes versions du Kit de développement logiciel (SDK) peuvent avoir des valeurs différentes.

XAML inclut également des ressources que vous pouvez utiliser pour modifier les couleurs d’un contrôle dans différents états visuels sans modifier le modèle de contrôle. La modification de ces ressources est préférable à la définition de propriétés telles que l’arrière-plan et le premier plan. Pour plus d’informations, consultez la section Style léger de l’article Styles XAML .

Constructeurs

CommandBarFlyout()

Initialise une nouvelle instance de la classe CommandBarFlyout.

Propriétés

AllowFocusOnInteraction	Obtient ou définit une valeur qui indique si l’élément obtient automatiquement le focus lorsque l’utilisateur interagit avec lui. (Hérité de FlyoutBase)
AllowFocusWhenDisabled	Obtient ou définit une valeur qui spécifie si le contrôle peut recevoir le focus lorsqu’il est désactivé. (Hérité de FlyoutBase)
AlwaysExpanded	Obtient ou définit une valeur qui indique si le CommandBarFlyout doit toujours rester dans son état Développé et empêcher l’utilisateur d’entrer l’état Réduit. La valeur par défaut est false.
AreOpenCloseAnimationsEnabled	Obtient ou définit une valeur qui indique si les animations sont lues lorsque le menu volant est ouvert ou fermé. (Hérité de FlyoutBase)
Dispatcher	Retourne null toujours dans une application SDK d'application Windows. Utilisez DispatcherQueue à la place. (Hérité de DependencyObject)
DispatcherQueue	Obtient le DispatcherQueue auquel cet objet est associé. DispatcherQueue représente une installation qui peut accéder au DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur. (Hérité de DependencyObject)
ElementSoundMode	Obtient ou définit une valeur qui spécifie la préférence du contrôle pour savoir s’il lit des sons. (Hérité de FlyoutBase)
InputDevicePrefersPrimaryCommands	Obtient une valeur qui indique si le périphérique d’entrée utilisé pour ouvrir le menu volant n’ouvre pas facilement les commandes secondaires. (Hérité de FlyoutBase)
IsConstrainedToRootBounds	Obtient une valeur qui indique si le menu volant est affiché dans les limites de la racine XAML. Cette propriété est toujours vraie pour les applications SDK d'application Windows. (Hérité de FlyoutBase)
IsOpen	Obtient une valeur qui indique si le menu volant est ouvert. (Hérité de FlyoutBase)
LightDismissOverlayMode	Obtient ou définit une valeur qui spécifie si la zone située à l’extérieur d’une interface utilisateur light-dismiss est assombrie. (Hérité de FlyoutBase)
OverlayInputPassThroughElement	Obtient ou définit un élément qui doit recevoir des événements d’entrée de pointeur, même sous la superposition du menu volant. (Hérité de FlyoutBase)
Placement	Obtient ou définit le placement par défaut à utiliser pour le menu volant, par rapport à sa cible de placement. (Hérité de FlyoutBase)
PrimaryCommands	Obtient la collection d’éléments de commande principaux pour CommandBarFlyout.
SecondaryCommands	Obtient la collection d’éléments de commande secondaires pour CommandBarFlyout.
ShouldConstrainToRootBounds	Obtient ou définit une valeur qui indique si le menu volant doit être affiché dans les limites de la racine XAML. (Hérité de FlyoutBase)
ShowMode	Obtient ou définit une valeur qui indique le comportement d’un menu volant lorsqu’il est affiché. (Hérité de FlyoutBase)
SystemBackdrop	Obtient ou définit l’arrière-plan système à appliquer à ce menu volant. L’arrière-plan est affiché derrière le contenu du menu volant. (Hérité de FlyoutBase)
Target	Obtient l’élément à utiliser comme cible de placement du menu volant. (Hérité de FlyoutBase)
XamlRoot	Obtient ou définit le XamlRoot dans lequel ce menu volant est en cours d’affichage. (Hérité de FlyoutBase)

Méthodes

ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject)
CreatePresenter()	En cas de substitution dans une classe dérivée, initialise un contrôle pour afficher le contenu du menu volant approprié pour le contrôle dérivé. Remarque : Cette méthode n’a pas d’implémentation de classe de base et doit être remplacée dans une classe dérivée. (Hérité de FlyoutBase)
GetAnimationBaseValue(DependencyProperty)	Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un objet DependencyObject. (Hérité de DependencyObject)
Hide()	Ferme le menu volant. (Hérité de FlyoutBase)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	Appelé juste avant qu’un raccourci clavier (accélérateur) ne soit traité dans votre application. Appelé chaque fois que le code d’application ou les processus internes appellent ProcessKeyboardAccelerators. Remplacez cette méthode pour influencer la gestion de l’accélérateur par défaut. (Hérité de FlyoutBase)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject)
ShowAt(DependencyObject, FlyoutShowOptions)	Affiche le menu volant placé par rapport à l’élément spécifié à l’aide des options spécifiées. (Hérité de FlyoutBase)
ShowAt(FrameworkElement)	Affiche le menu volant placé par rapport à l’élément spécifié. (Hérité de FlyoutBase)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Tente d’appeler un raccourci clavier (accélérateur). (Hérité de FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject)

Événements

Closed	Se produit lorsque le menu volant est masqué. (Hérité de FlyoutBase)
Closing	Se produit lorsque le menu volant commence à être masqué. (Hérité de FlyoutBase)
Opened	Se produit lorsque le menu volant s’affiche. (Hérité de FlyoutBase)
Opening	Se produit avant l’affichage du menu volant. (Hérité de FlyoutBase)

Voir aussi

• Menu volant de barre de commandes