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

Public Property LabelPosition As CommandBarLabelPosition

<AppBarButton LabelPosition="commandBarLabelPositionMemberName" />

屬性值

CommandBarLabelPosition

列舉值，指定按鈕標籤的位置和可見性。 預設值為 Default。

備註

根據預設，應用程式行按鈕的標籤會顯示在 CommandBar.DefaultLabelPosition 屬性所指定的位置。 您可以設定 LabelPosition 屬性來覆寫此值，並讓標籤一律折疊特定應用程式行按鈕。

版本相容性

Windows 10 1607 版之前，無法使用 LabelPosition 屬性。 如果您的應用程式在 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;
    }
}