CommandBarFlyout Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un menu volant spécialisé qui fournit la disposition pour AppBarButton et les éléments de commande associés.
API WinUI 2 équivalente pour UWP : Microsoft.UI.Xaml.Controls.CommandBarFlyout (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
/// [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>
- Héritage
- Dérivé
- Attributs
Configuration requise pour Windows
Famille d’appareils |
Windows 10, version 1809 (introduit dans 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v7.0)
|
Exemples
Conseil
Pour plus d’informations, des conseils de conception et des exemples de code, consultez menu volant de la barre de commandes.
Si vous avez installé l’application WinUI 2 Gallery , cliquez ici pour ouvrir l’application et voir commandBarFlyout en action.
Remarques
Modèle et style de contrôle
Vous pouvez modifier le Style et le ControlTemplate par défaut 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 Contrôles de style. 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 disponible localement avec l’installation du sdk ou du package NuGet.
- * Styles WinUI (recommandés) : Utilisez Microsoft.UI.Xaml.Controls.CommandBarFlyout.
-
Styles non WinUI : Pour les styles intégrés, consultez
%ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml
.
Les emplacements peuvent être différents si vous avez personnalisé l’installation. 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 Styles légers de l’article Styles XAML . Les ressources de style légères sont disponibles à partir de Windows 10, version 1607 (SDK 14393).
Constructeurs
CommandBarFlyout() |
Initialise une nouvelle instance de la classe CommandBarFlyout. API WinUI 2 équivalente pour UWP : Microsoft.UI.Xaml.Controls.CommandBarFlyout.-ctor (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). |
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) |
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 |
Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une fonctionnalité qui peut accéder à 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. (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 à l’extérieur d’une interface utilisateur d’assombrie 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. API WinUI 2 équivalente pour UWP : Microsoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). |
SecondaryCommands |
Obtient la collection d’éléments de commande secondaires pour CommandBarFlyout. API WinUI 2 équivalente pour UWP : Microsoft.UI.Xaml.Controls.CommandBarFlyout.SecondaryCommands (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). |
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) |
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 consulté. (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’appliquerait 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 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 du code d’application ou des 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 est affiché. (Hérité de FlyoutBase) |
Opening |
Se produit avant l’affichage du menu volant. (Hérité de FlyoutBase) |