AppBarButton.LabelPosition 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值指示按钮标签的位置和可见性。
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。
注解
默认情况下,应用栏按钮的标签显示在 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;
}
}