CommandBar.DefaultLabelPosition Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit une valeur qui indique le positionnement 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 positionnement et la visibilité des étiquettes sur les boutons de la barre de commandes. La valeur par défaut est Bottom.

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

Par défaut, l’étiquette d’un bouton de barre de l’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 faire en sorte que l’étiquette soit 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 de plateforme minimale » 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 tenir compte de cela. Pour plus d’informations, consultez Code adaptatif de version.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions antérieures 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;
    }
}