AppBarButton.DynamicOverflowOrder Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mendapatkan atau mengatur urutan di mana item ini dipindahkan ke menu luapan CommandBar .

public:
 property int DynamicOverflowOrder { int get(); void set(int value); };

int DynamicOverflowOrder();

void DynamicOverflowOrder(int value);

public int DynamicOverflowOrder { get; set; }

var int32 = appBarButton.dynamicOverflowOrder;
appBarButton.dynamicOverflowOrder = int32;

Public Property DynamicOverflowOrder As Integer

<AppBarButton DynamicOverflowOrder="int" .../>

Nilai Properti

Int32

int

Urutan di mana item ini dipindahkan ke menu luapan relatif terhadap item lain.

Penerapan

DynamicOverflowOrder

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.

Properti ini hanya berpengaruh ketika elemen ini berada di koleksi CommandBar.PrimaryCommands dan CommandBar.IsDynamicOverflowEnabled adalah true.

Anda dapat menetapkan nilai DynamicOverflowOrder yang sama ke lebih dari satu elemen. Elemen dengan nilai yang sama bergerak masuk dan keluar dari area luapan secara bersamaan.

Kompatibilitas versi

Properti DynamicOverflowOrder 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 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">
    <AppBarButton x:Name="appBarButtonCut" Icon="Cut" Label="Cut"/>
    <AppBarButton x:Name="appBarButtonCopy" Icon="Copy" Label="Copy"/>
    <AppBarSeparator x:Name="appBarSeparator1"/>
    <AppBarButton x:Name="appBarButtonPaste" Icon="Paste" Label="Paste"/>
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarButton", "DynamicOverflowOrder"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
        appBarButtonCut.DynamicOverflowOrder = 1;
        appBarButtonCopy.DynamicOverflowOrder = 2;
        appBarSeparator1.DynamicOverflowOrder = 2;
        appBarButtonPaste.DynamicOverflowOrder = 3;
    }
}