CommandBar.DefaultLabelPosition Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mendapatkan atau menetapkan nilai yang menunjukkan penempatan dan visibilitas label pada tombol bilah perintah.

public:
 property CommandBarDefaultLabelPosition DefaultLabelPosition { CommandBarDefaultLabelPosition get(); void set(CommandBarDefaultLabelPosition value); };

CommandBarDefaultLabelPosition DefaultLabelPosition();

void DefaultLabelPosition(CommandBarDefaultLabelPosition value);

public CommandBarDefaultLabelPosition DefaultLabelPosition { get; set; }

var commandBarDefaultLabelPosition = commandBar.defaultLabelPosition;
commandBar.defaultLabelPosition = commandBarDefaultLabelPosition;

Public Property DefaultLabelPosition As CommandBarDefaultLabelPosition

<CommandBar DefaultLabelPosition="commandBarDefaultLabelPositionMemberName" />

Nilai Properti

CommandBarDefaultLabelPosition

Nilai enumerasi yang menunjukkan penempatan dan visibilitas label pada tombol bilah perintah. Defaultnya adalah Bawah.

Keterangan

Secara default, label tombol bilah aplikasi ditampilkan di bawah ikon. Anda dapat mengatur properti ini untuk menampilkan label di sebelah kanan ikon, atau untuk menyembunyikan label.

Anda dapat mengatur properti AppBarButton.LabelPosition untuk mengambil alih nilai ini dan membuat label selalu diciutkan untuk tombol bilah aplikasi tertentu.

Kompatibilitas versi

Properti DefaultLabelPosition tidak tersedia sebelum Windows 10, versi 1607. Jika pengaturan 'versi platform minimum' aplikasi Anda di Microsoft Visual Studio kurang dari 'versi yang diperkenalkan' yang ditunjukkan di blok Persyaratan nanti di halaman ini, Anda harus merancang dan menguji aplikasi Anda untuk mempertanyakan hal ini. Untuk informasi selengkapnya, lihat Kode adaptif versi.

Untuk menghindari pengecualian saat aplikasi Anda berjalan pada versi Windows 10 sebelumnya, jangan atur properti ini di XAML atau gunakan tanpa melakukan pemeriksaan runtime. Contoh ini menunjukkan cara menggunakan kelas ApiInformation untuk memeriksa keberadaan properti ini sebelum Anda mengaturnya.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    ...
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.CommandBar", "DefaultLabelPosition"))
    {
        commandBar1.DefaultLabelPosition = CommandBarDefaultLabelPosition.Right;
    }
}