AppBarButton.LabelPosition 属性

定义

命名空间:

Windows.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 = appBarButton.labelPosition;
appBarButton.labelPosition = commandBarLabelPosition;

Public Property LabelPosition As CommandBarLabelPosition

<AppBarButton LabelPosition="commandBarLabelPositionMemberName" />

属性值

CommandBarLabelPosition

一个枚举值，该值指定按钮标签的位置和可见性。 默认值为 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;
    }
}