CommandBar.DefaultLabelPosition Propriedade

Definição

Obtém ou define um valor que indica o posicionamento e a visibilidade dos rótulos nos botões da barra de comandos.

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

Valor da propriedade

Um valor de enumeração que indica o posicionamento e a visibilidade dos rótulos nos botões da barra de comandos. O padrão é Bottom.

Comentários

Por padrão, o rótulo de um botão da barra de aplicativos é exibido abaixo do ícone. Você pode definir essa propriedade para mostrar rótulos à direita do ícone ou ocultar rótulos.

Você pode definir a propriedade AppBarButton.LabelPosition para substituir esse valor e fazer com que o rótulo sempre seja recolhido para um botão específico da barra de aplicativos.

Compatibilidade entre versões

A propriedade DefaultLabelPosition não está disponível antes do Windows 10, versão 1607. Se a configuração de "versão mínima da plataforma" do aplicativo no Microsoft Visual Studio for menor do que a "versão introduzida" mostrada no bloco Requisitos posteriormente nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte o código adaptável de versão.

Para evitar exceções quando seu aplicativo for executado em versões anteriores do Windows 10, não defina essa propriedade em XAML ou use-a sem executar uma verificação de runtime. Este exemplo mostra como usar a classe ApiInformation para verificar a presença dessa propriedade antes de defini-la.

<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;
    }
}

Aplica-se a