RadioButtons Kelas
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.
Mewakili kontrol yang memperlihatkan sekelompok opsi terkait dari mana yang dapat dipilih.
Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [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.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Items")]
class RadioButtons : Control
/// [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.UI.Xaml.Markup.ContentProperty(Name="Items")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class RadioButtons : Control
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[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.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Items")]
public class RadioButtons : Control
[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.UI.Xaml.Markup.ContentProperty(Name="Items")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class RadioButtons : Control
Public Class RadioButtons
Inherits Control
- Warisan
-
RadioButtons
- Atribut
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContentPropertyAttribute ContractVersionAttribute
Contoh
Tip
Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat tombol Radio.
Aplikasi WinUI 2 Gallery mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 2. Dapatkan aplikasi dari Microsoft Store atau dapatkan kode sumber di GitHub.
Keterangan
Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat Tombol radio.
Gunakan tombol radio, juga disebut tombol opsi, untuk memungkinkan pengguna memilih satu opsi dari koleksi dua atau lebih opsi yang saling eksklusif, tetapi terkait. Tombol radio selalu digunakan dalam grup, dan setiap opsi diwakili oleh satu tombol radio dalam grup.
Kontrol RadioButtons
menyederhanakan tata letak, menangani navigasi dan aksesibilitas keyboard, dan mendukung pengikatan ke sumber data. Saat menggunakan RadioButtons, Anda dapat memperlakukan sekelompok opsi Anda sebagai satu entitas, daripada melacak kontrol RadioButton individual.
Kontrol RadioButtons
menggunakan model konten yang mirip dengan ItemsControl. Ini berarti Anda dapat:
- Isi dengan menambahkan item langsung ke koleksi Item atau dengan mengikat data ke properti ItemsSource-nya .
- Gunakan properti SelectedIndex atau SelectedItem untuk mendapatkan dan mengatur opsi mana yang dipilih.
- Tangani peristiwa SelectionChanged untuk mengambil tindakan saat opsi dipilih.
Gaya kontrol dan templat
Anda dapat mengubah Gaya dan ControlTemplate default untuk memberikan tampilan unik pada kontrol. Untuk informasi tentang memodifikasi gaya dan templat kontrol, lihat gaya XAML. Gaya, templat, dan sumber daya default yang menentukan tampilan kontrol disertakan dalam generic.xaml
file. Untuk tujuan desain, generic.xaml
diinstal dengan paket NuGet WinUI (Microsoft.UI.Xaml). Secara default, lokasi ini adalah \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml
. Gaya dan sumber daya dari versi WinUI yang berbeda mungkin memiliki nilai yang berbeda.
XAML juga menyertakan sumber daya yang dapat Anda gunakan untuk memodifikasi warna kontrol dalam status visual yang berbeda tanpa memodifikasi templat kontrol. Memodifikasi sumber daya ini lebih disukai untuk mengatur properti seperti Latar Belakang dan Latar Depan. Untuk informasi selengkapnya, lihat bagian Gaya ringan dari artikel gaya XAML .
Konstruktor
RadioButtons() |
Menginisialisasi instans baru kelas RadioButtons . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
Properti
Header |
Mendapatkan atau mengatur konten untuk header grup. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
HeaderProperty |
Mengidentifikasi properti dependensi Header . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
HeaderTemplate |
Mendapatkan atau mengatur templat data yang digunakan untuk menampilkan konten header kontrol. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
HeaderTemplateProperty |
Mengidentifikasi properti dependensi HeaderTemplate . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
Items |
Mendapatkan koleksi yang digunakan untuk menghasilkan konten kontrol. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
ItemsProperty |
Mengidentifikasi properti dependensi Item . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
ItemsSource |
Mendapatkan atau mengatur sumber objek yang digunakan untuk menghasilkan konten kontrol. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
ItemsSourceProperty |
Mengidentifikasi properti dependensi ItemsSource . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
ItemTemplate |
Mendapatkan atau mengatur DataTemplate yang digunakan untuk menampilkan setiap item. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
ItemTemplateProperty |
Mengidentifikasi properti dependensi ItemTemplate . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
MaxColumns |
Mendapatkan atau mengatur jumlah maksimum kolom yang disusun tombol radio. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
MaxColumnsProperty |
Mengidentifikasi properti dependensi MaxColumns . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
SelectedIndex |
Mendapatkan atau mengatur indeks tombol radio yang dipilih. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
SelectedIndexProperty |
Mengidentifikasi properti dependensi SelectedIndex . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
SelectedItem |
Mendapatkan atau menyetel tombol radio yang dipilih. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
SelectedItemProperty |
Mengidentifikasi properti dependensi SelectedItem . Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
Metode
ContainerFromIndex(Int32) |
Mengembalikan kontainer untuk item pada indeks yang ditentukan dalam kumpulan item. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |
Acara
SelectionChanged |
Terjadi ketika item terpilih saat ini berubah. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows). |