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 プロパティを設定してこの値をオーバーライドし、特定のアプリ バー ボタンのラベルを常に折りたたむことができます。

バージョンの互換性

LabelPosition プロパティは、バージョン 1607 より前Windows 10使用できません。 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;
    }
}