AppBarToggleButton.LabelPosition Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Возвращает или задает значение, указывающее расположение и видимость метки кнопки.

public:
 property CommandBarLabelPosition LabelPosition { CommandBarLabelPosition get(); void set(CommandBarLabelPosition value); };

CommandBarLabelPosition LabelPosition();

void LabelPosition(CommandBarLabelPosition value);

public CommandBarLabelPosition LabelPosition { get; set; }

var commandBarLabelPosition = appBarToggleButton.labelPosition;
appBarToggleButton.labelPosition = commandBarLabelPosition;

Public Property LabelPosition As CommandBarLabelPosition

<AppBarToggleButton LabelPosition="commandBarLabelPositionMemberName" />

Значение свойства

CommandBarLabelPosition

Значение перечисления, указывающее расположение и видимость метки кнопки. Значение по умолчанию — Default.

Комментарии

По умолчанию метка кнопки панели приложения отображается в позиции, заданной свойством CommandBar.DefaultLabelPosition . Вы можете задать свойство LabelPosition, чтобы переопределить это значение и сделать метку всегда свернутой для определенной кнопки панели приложения.

Совместимость версий

Свойство LabelPosition недоступно до Windows 10 версии 1607. Если параметр "минимальная версия платформы" вашего приложения в Microsoft Visual Studio меньше значения "введенной версии", показанной в блоке "Требования" далее на этой странице, необходимо разработать и протестировать приложение, чтобы учесть это. Дополнительные сведения см. в разделе Адаптивный к версии код.

Чтобы избежать исключений при запуске приложения в предыдущих версиях Windows 10, не устанавливайте это свойство в XAML и не используйте его без выполнения проверка среды выполнения. В этом примере показано, как использовать класс ApiInformation для проверка наличия этого свойства перед его настройкой.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarToggleButton x:Name="appBarButtonShuffle" Icon="Shuffle" Label="Shuffle"/>
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarToggleButton", "LabelPosition"))
    {
        appBarButtonShuffle.LabelPosition = CommandBarLabelPosition.Collapsed;
    }
}