UniformGridLayout Kelas

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Memposisikan elemen secara berurutan dari kiri ke kanan atau atas ke bawah dalam tata letak pembungkusan.

Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class UniformGridLayout : VirtualizingLayout

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class UniformGridLayout : VirtualizingLayout

Public Class UniformGridLayout
Inherits VirtualizingLayout

Warisan

DependencyObject

Layout

VirtualizingLayout

UniformGridLayout

Atribut

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Contoh

Tip

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat ItemsRepeater.

Aplikasi Galeri WinUI 3 dan Galeri WinUI 2 mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 3 dan WinUI 2.

Jika sudah diinstal, buka dengan mengklik tautan berikut: Galeri WinUI 3 atau Galeri WinUI 2.

Jika tidak diinstal, Anda dapat mengunduh Galeri WinUI 3 dan Galeri WinUI 2 dari Microsoft Store.

Anda juga bisa mendapatkan kode sumber untuk keduanya dari GitHub (gunakan cabang utama untuk WinUI 3 dan cabang winui2 untuk WinUI 2).

Contoh berikut menunjukkan cara mengatur properti ItemsRepeater.Layout ke UniformGridLayout.

<!--
    xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->
...
<muxc:ItemsRepeater ItemsSource="{x:Bind Items}"
                    ItemTemplate="{StaticResource MyTemplate}">
    <muxc:ItemsRepeater.Layout>
        <muxc:UniformGridLayout MinItemWidth="200"
                                MinColumnSpacing="28"
                                ItemsJustification="SpaceAround"/>
    </muxc:ItemsRepeater.Layout>
</muxc:ItemsRepeater>

Keterangan

Item diletakkan secara berurutan dari kiri-ke-kanan saat Orientasi adalah Horizontal, dan diletakkan dari atas ke bawah saat Orientasi adalah Vertical.

Setiap item dalam UniformGridLayout berukuran sama.

UniformGridLayout mendukung virtualisasi saat dilampirkan ke host yang mendukung virtualisasi.

Konstruktor

UniformGridLayout()

Menginisialisasi instans baru kelas UniformGridLayout . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Properti

ItemsJustification	Mendapatkan atau menetapkan nilai yang menunjukkan bagaimana item diratakan pada sumbu non-gulir atau non-virtualisasi. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ItemsJustificationProperty	Mengidentifikasi properti dependensi ItemsJustification . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ItemsStretch	Mendapatkan atau menetapkan nilai yang menunjukkan bagaimana item berukuran untuk mengisi ruang yang tersedia. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ItemsStretchProperty	Mengidentifikasi properti dependensi ItemsStretch . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MaximumRowsOrColumns	Mendapatkan atau mengatur jumlah maksimum item yang dirender per baris atau kolom, berdasarkan orientasi UniformGridLayout. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MaximumRowsOrColumnsProperty	Mengidentifikasi properti dependensi MaximumRowsOrColumns . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MinColumnSpacing	Mendapatkan atau mengatur ruang minimum di antara item pada sumbu horizontal. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MinColumnSpacingProperty	Mengidentifikasi properti dependensi MinColumnSpacing . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MinItemHeight	Mendapatkan atau mengatur tinggi minimum setiap item. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MinItemHeightProperty	Mengidentifikasi properti dependensi MinItemHeight . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MinItemWidth	Mendapatkan atau mengatur lebar minimum setiap item. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MinItemWidthProperty	Mengidentifikasi properti dependensi MinItemWidth . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MinRowSpacing	Mendapatkan atau mengatur ruang minimum di antara item pada sumbu vertikal. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
MinRowSpacingProperty	Mengidentifikasi properti dependensi MinRowSpacing . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
Orientation	Mendapatkan atau mengatur sumbu di mana item ditata. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
OrientationProperty	Mengidentifikasi properti dependensi Orientasi . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Metode

Arrange(LayoutContext, Size)	Memposisikan elemen anak dan menentukan ukuran untuk UIElement kontainer. Elemen kontainer yang mendukung tata letak terlampir harus memanggil metode ini dari implementasi penimpaan tata letaknya untuk membentuk pembaruan tata letak rekursif. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari Layout)
ArrangeOverride(VirtualizingLayoutContext, Size)	Saat diimplementasikan di kelas turunan, berikan perilaku untuk pass tata letak "Susun". Kelas dapat mengambil alih metode ini untuk menentukan perilaku pass "Arrange" mereka sendiri. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari VirtualizingLayout)
InitializeForContext(LayoutContext)	Menginisialisasi status per kontainer yang diperlukan tata letak saat dilampirkan ke kontainer UIElement. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari Layout)
InitializeForContextCore(VirtualizingLayoutContext)	Saat ditimpa dalam kelas turunan, menginisialisasi status per kontainer yang diperlukan tata letak saat dilampirkan ke kontainer UIElement. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari VirtualizingLayout)
InvalidateArrange()	Membatalkan status susun (tata letak) untuk semua kontainer UIElement yang mereferensikan tata letak ini. Setelah pembatalan, UIElement akan memperbarui tata letaknya, yang terjadi secara asinkron. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari Layout)
InvalidateMeasure()	Membatalkan status pengukuran (tata letak) untuk semua kontainer UIElement yang mereferensikan tata letak ini. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari Layout)
Measure(LayoutContext, Size)	Menyarankan DesiredSize untuk elemen kontainer. Elemen kontainer yang mendukung tata letak terlampir harus memanggil metode ini dari implementasi MeasureOverride mereka sendiri untuk membentuk pembaruan tata letak rekursif. Tata letak terlampir diharapkan memanggil Pengukuran untuk setiap turunan UIElement kontainer. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari Layout)
MeasureOverride(VirtualizingLayoutContext, Size)	Menyediakan perilaku untuk lulus "Ukur" dari siklus tata letak. Kelas dapat mengambil alih metode ini untuk menentukan perilaku lulus "Ukur" mereka sendiri. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)	Memberi tahu tata letak saat pengumpulan data yang ditetapkan ke elemen kontainer (ItemsSource) telah berubah. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari VirtualizingLayout)
UninitializeForContext(LayoutContext)	Menghapus status apa pun yang sebelumnya disimpan di kontainer UIElement. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari Layout)
UninitializeForContextCore(VirtualizingLayoutContext)	Saat ditimpa di kelas turunan, menghapus status apa pun yang sebelumnya disimpan pada kontainer UIElement. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari VirtualizingLayout)

Acara

ArrangeInvalidated	Terjadi ketika status susun (tata letak) telah dibatalkan. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari Layout)
MeasureInvalidated	Terjadi ketika status pengukuran (tata letak) telah dibatalkan. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). (Diperoleh dari Layout)

Lihat juga

• UniformGridLayoutItemsJustification
• UniformGridLayoutItemsStretch
• Gambaran umum UniformGridLayout