Ekspander

"Expander mengizinkan pengguna untuk melihat header dan memperluas header tersebut untuk melihat detail lebih lanjut, atau menciutkan bagian hingga ke header." Expander Elemen kontrol menyediakan cara untuk menyajikan konten di area yang dapat diperluas yang menyerupai jendela serta menyertakan header.

Cuplikan layar berbagai jenis kontrol expander.

Judul Description
Membuat Expander dengan ScrollViewer Pelajari cara membuat kontrol Expander yang berisi konten kompleks dengan ScrollViewer.

Mengatur arah area konten yang diperluas

Anda dapat mengatur area konten dari kontrol Expander untuk diperluas di salah satu dari empat arah: Down, Up, Left, atau Right dengan menggunakan properti ExpandDirection. Saat area konten diciutkan, hanya header Expander dan tombol penukarnya yang muncul. Button Kontrol yang menampilkan panah arah digunakan sebagai tombol alih untuk memperluas atau menciutkan area konten. Saat diperluas, Expander mencoba menampilkan semua kontennya di area seperti jendela.

Mengontrol ukuran Expander di panel

Expander Jika kontrol berada di dalam kontrol tata letak yang mewarisi dari Panel, seperti StackPanel, jangan tentukan Height pada Expander ketika properti ExpandDirection diatur ke Down atau Up. Demikian pula, jangan tentukan Width pada Expander saat ExpandDirection properti diatur ke Left atau Right.

Saat Anda mengatur dimensi ukuran pada Expander kontrol ke arah konten yang diperluas ditampilkan, Expander mengambil kontrol area yang digunakan oleh konten dan menampilkan batas di sekitarnya. Batas tampak meskipun konten diciutkan. Untuk mengatur ukuran area konten yang diperluas, atur dimensi ukuran pada konten Expander, atau jika Anda ingin kemampuan menggulir, atur pada ScrollViewer yang melingkupi konten.

Expander Ketika kontrol adalah elemen terakhir dalam DockPanel, Windows Presentation Foundation (WPF) secara otomatis mengatur Expander dimensi agar sama dengan area yang tersisa dari DockPanel. Untuk mencegah perilaku default ini, atur LastChildFill properti pada DockPanel objek ke false, atau pastikan bahwa Expander bukan elemen terakhir dalam DockPanel.

Membuat konten yang dapat digulir

Jika konten terlalu besar untuk ukuran area konten, Anda dapat menempatkan konten di dalam Expander ke dalam ScrollViewer untuk menyediakan konten yang dapat digulir. Kontrol Expander tidak secara otomatis menyediakan kemampuan gulir.

Saat Anda menempatkan Expander kontrol ke dalam ScrollViewer, atur properti dimensi ScrollViewer yang sesuai dengan arah di mana konten Expander terbuka, sehingga mencocokkan dengan ukuran area konten Expander. Misalnya, jika Anda mengatur properti ExpandDirection pada Expander ke Down (area konten terbuka ke bawah), atur properti Height pada kontrol ScrollViewer ke tinggi yang diperlukan untuk area konten. Jika Anda mengatur dimensi tinggi pada konten itu sendiri, ScrollViewer tidak mengenali pengaturan ini dan karenanya tidak menyediakan konten yang dapat digulir.

Menggunakan properti perataan

Anda dapat mengatur penjajaran konten dengan mengatur properti HorizontalContentAlignment dan VerticalContentAlignment pada kontrol Expander. Saat Anda mengatur properti ini, perataan berlaku untuk header dan juga konten yang diperluas.

Gaya dan templat

Anda dapat memodifikasi gaya dan templat untuk Expander kontrol guna memberi kontrol tampilan yang unik. Untuk informasi selengkapnya, lihat Apa itu gaya dan templat? dan Cara membuat templat untuk kontrol.

Properti konten

Properti konten dari Expander adalah Content, yang mewakili konten yang ditampilkan di area kontrol yang dapat diperluas.

Bagian

Kontrol Expander memiliki bagian bernama berikut:

Nama Bagian Jenis Bagian Description
HeaderSite ToggleButton Tombol sakelar yang membuka dan menutup penyebar.

Keadaan visual

Tabel berikut mencantumkan status visual untuk Expander kontrol.

Nama VisualState Nama VisualStateGroup Description
Biasa CommonStates Kontrol berada dalam keadaan normal.
MouseOver CommonStates Mouse berada di atas kontrol.
Disabled CommonStates Kontrol dinonaktifkan.
Terfokus FocusStates Kontrol memiliki fokus keyboard.
Tidak fokus FocusStates Kontrol tidak memiliki fokus keyboard.
Expanded ExpansionStates Kontrol diperluas.
Roboh ExpansionStates Kontrol dilipat.
Perluas ke Bawah ExpandDirectionStates Kontrol diperluas ke bawah.
Perluas Ke Atas ExpandDirectionStates Kontrol meluas ke atas.
PerluasKiri ExpandDirectionStates Kontrol meluas ke kiri.
PerluasKanan ExpandDirectionStates Elemen kontrol berkembang ke kanan.
Sah StatusValidasi Kontrol valid dan tidak memiliki kesalahan validasi.
FokusTidakValid StatusValidasi Kontrol memiliki kesalahan validasi dan memiliki fokus keyboard.
Tidak valid dan Tidak Difokuskan StatusValidasi Kontrol memiliki kesalahan validasi tetapi tidak memiliki fokus keyboard.

Lihat juga