RadioButtons Kelas

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

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.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.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

Control

RadioButtons

Atribut

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

Contoh

Tip

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat tombol Radio.

Buka aplikasi WinUI 2 Gallery dan lihat RadioButton beraksi.

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).

Lihat juga

• Tombol radio