Поделиться через


AppBarButton.LabelPosition Свойство

Определение

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

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

void LabelPosition(CommandBarLabelPosition value);
public CommandBarLabelPosition LabelPosition { get; set; }
var commandBarLabelPosition = appBarButton.labelPosition;
appBarButton.labelPosition = commandBarLabelPosition;
Public Property LabelPosition As CommandBarLabelPosition
<AppBarButton LabelPosition="commandBarLabelPositionMemberName" />

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

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

Требования к Windows

Семейство устройств
Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v3.0)

Комментарии

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

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

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

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

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarButton x:Name="appBarButtonCut" Icon="Cut" Label="Cut"/>
</CommandBar>
private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarButton", "LabelPosition"))
    {
        appBarButtonCut.LabelPosition = CommandBarLabelPosition.Collapsed;
    }
}

Применяется к