AppBarSeparator.DynamicOverflowOrder Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur urutan di mana item ini dipindahkan ke menu luapan Bilah Perintah .
public:
property int DynamicOverflowOrder { int get(); void set(int value); };
int DynamicOverflowOrder();
void DynamicOverflowOrder(int value);
public int DynamicOverflowOrder { get; set; }
var int32 = appBarSeparator.dynamicOverflowOrder;
appBarSeparator.dynamicOverflowOrder = int32;
Public Property DynamicOverflowOrder As Integer
<AppBarSeparator DynamicOverflowOrder="int" .../>
Nilai Properti
int
Urutan di mana item ini dipindahkan ke menu luapan relatif terhadap item lain.
Penerapan
Persyaratan Windows
Rangkaian perangkat |
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)
|
Keterangan
Untuk informasi dan panduan selengkapnya, lihat artikel Bilah aplikasi dan bilah perintah .
Mulai dari Windows 10, versi 1607, CommandBar memperkenalkan fitur luapan dinamis. Secara default, PrimaryCommands secara otomatis 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, 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.AppBarSeparator", "DynamicOverflowOrder"))
{
commandBar1.IsDynamicOverflowEnabled = true;
appBarButtonCut.DynamicOverflowOrder = 1;
appBarButtonCopy.DynamicOverflowOrder = 2;
appBarSeparator1.DynamicOverflowOrder = 2;
appBarButtonPaste.DynamicOverflowOrder = 3;
}
}