CommandBar.DefaultLabelPosition Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient ou définit une valeur qui indique l’emplacement et la visibilité des étiquettes sur les boutons de la barre de commandes.

public:
 property CommandBarDefaultLabelPosition DefaultLabelPosition { CommandBarDefaultLabelPosition get(); void set(CommandBarDefaultLabelPosition value); };

CommandBarDefaultLabelPosition DefaultLabelPosition();

void DefaultLabelPosition(CommandBarDefaultLabelPosition value);

public CommandBarDefaultLabelPosition DefaultLabelPosition { get; set; }

var commandBarDefaultLabelPosition = commandBar.defaultLabelPosition;
commandBar.defaultLabelPosition = commandBarDefaultLabelPosition;

Public Property DefaultLabelPosition As CommandBarDefaultLabelPosition

<CommandBar DefaultLabelPosition="commandBarDefaultLabelPositionMemberName" />

Valeur de propriété

CommandBarDefaultLabelPosition

Valeur d’énumération qui indique le placement et la visibilité des étiquettes sur les boutons de la barre de commandes. La valeur par défaut est Bottom.

Remarques

Par défaut, l’étiquette d’un bouton de barre d’application s’affiche sous l’icône. Vous pouvez définir cette propriété pour afficher les étiquettes à droite de l’icône ou pour masquer les étiquettes.

Vous pouvez définir la propriété AppBarButton.LabelPosition pour remplacer cette valeur et rendre l’étiquette toujours réduite pour un bouton de barre d’application spécifique.

Compatibilité des versions

La propriété DefaultLabelPosition n’est pas disponible avant Windows 10, version 1607. Si le paramètre « version minimale de la plateforme » de votre application dans Microsoft Visual Studio est inférieur à la « version introduite » indiquée dans le bloc Configuration requise plus loin dans cette page, vous devez concevoir et tester votre application pour en tenir compte. Pour plus d’informations, consultez Code adaptatif version.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions précédentes de Windows 10, ne définissez pas cette propriété en XAML ou ne l’utilisez pas sans effectuer de case activée d’exécution. Cet exemple montre comment utiliser la classe ApiInformation pour case activée la présence de cette propriété avant de la définir.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    ...
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.CommandBar", "DefaultLabelPosition"))
    {
        commandBar1.DefaultLabelPosition = CommandBarDefaultLabelPosition.Right;
    }
}