CommandBar.IsDynamicOverflowEnabled Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mendapatkan atau mengatur nilai yang menunjukkan apakah perintah utama secara otomatis berpindah ke menu luapan saat ruang dibatasi.

public:
 property bool IsDynamicOverflowEnabled { bool get(); void set(bool value); };

bool IsDynamicOverflowEnabled();

void IsDynamicOverflowEnabled(bool value);

public bool IsDynamicOverflowEnabled { get; set; }

var boolean = commandBar.isDynamicOverflowEnabled;
commandBar.isDynamicOverflowEnabled = boolean;

Public Property IsDynamicOverflowEnabled As Boolean

<CommandBar IsDynamicOverflowEnabled="bool"/>

Nilai Properti

Boolean

bool

true jika perintah utama secara otomatis berpindah ke menu luapan saat ruang dibatasi; jika tidak, salah. Defaultnya adalah true

Keterangan

Untuk informasi dan panduan selengkapnya, lihat artikel Bilah perintah .

Mulai Windows 10, versi 1607, CommandBar memperkenalkan fitur luapan dinamis. Secara default, PrimaryCommands secara otomatis berpindah masuk atau keluar dari area luapan saat lebar bilah perintah berubah, misalnya, saat pengguna mengubah ukuran jendela aplikasi mereka. Anda dapat mengatur properti IsDynamicOverflowEnabled ke false untuk menonaktifkan perilaku ini.

Luapan dinamis hanya memengaruhi presentasi UI perintah, itu tidak memindahkan perintah dari koleksi PrimaryCommands ke SecondaryCommands.

Kompatibilitas versi

Properti IsDynamicOverflowEnabled 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.

Catatan

Luapan dinamis tersedia saat aplikasi Anda dikompilasi untuk Windows 10, versi 1607 dan berjalan pada versi 1607 (atau yang lebih baru). Luapan dinamis tidak tersedia saat aplikasi Anda dikompilasi untuk versi sebelumnya atau berjalan pada versi sebelumnya.

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

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

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