RadioButtons Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Rappresenta un controllo che mostra un gruppo di opzioni correlate da cui è possibile selezionare uno.

Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di 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

Ereditarietà

Control

RadioButtons

Attributi

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

Esempio

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Pulsante di opzione.

Aprire l'app Raccolta WinUI 2 e vedere radioButton in azione.

L'app Raccolta WinUI 2 include esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità winUI 2. Ottenere l'app da Microsoft Store o ottenere il codice sorgente in GitHub.

Commenti

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Pulsanti di opzione.

Usare pulsanti di opzione, detti anche pulsanti di opzione, per consentire agli utenti di selezionare un'opzione da una raccolta di due o più opzioni che si escludono a vicenda, ma correlate. I pulsanti di opzione vengono sempre usati in gruppi e ogni opzione è rappresentata da un solo pulsante nel gruppo.

Il RadioButtons controllo semplifica il layout, gestisce lo spostamento tramite tastiera e l'accessibilità e supporta l'associazione a un'origine dati. Quando si usano RadioButton, è possibile considerare il gruppo di opzioni come una singola entità, anziché tenere traccia dei singoli controlli RadioButton .

Il controllo RadioButtons usa un modello di contenuto simile a un elemento ItemsControl. È quindi possibile:

• Popolarlo aggiungendo elementi direttamente alla raccolta Items o associando i dati alla relativa proprietà ItemsSource.
• Usare la proprietà SelectedIndex o SelectedItem per ottenere e impostare l'opzione che deve essere selezionata.
• Gestire l'evento SelectionChanged in modo che agisca quando si sceglie un'opzione.

Stile di controllo e modello

È possibile modificare lo stile predefinito e controlTemplate per assegnare al controllo un aspetto univoco. Per informazioni sulla modifica dello stile e del modello di un controllo, vedi Stili XAML. Lo stile predefinito, il modello e le risorse che definiscono l'aspetto del controllo sono inclusi nel generic.xaml file. Ai fini della progettazione, generic.xaml viene installato con il pacchetto NuGet WinUI (Microsoft.UI.Xaml). Per impostazione predefinita, il percorso è \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Gli stili e le risorse di versioni diverse di WinUI potrebbero avere valori diversi.

XAML include anche risorse che è possibile usare per modificare i colori di un controllo in stati di visualizzazione diversi senza modificare il modello di controllo. La modifica di queste risorse è preferibile per impostare proprietà come Background e Foreground. Per altre info, vedi la sezione Stili leggeri dell'articolo Stili XAML .

Costruttori

RadioButtons()

Inizializza una nuova istanza della classe RadioButtons . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

Proprietà

Header	Ottiene o imposta il contenuto per l'intestazione del gruppo. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
HeaderProperty	Identifica la proprietà di dipendenza Header . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
HeaderTemplate	Ottiene o imposta il modello di dati utilizzato per visualizzare il contenuto dell'intestazione del controllo. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
HeaderTemplateProperty	Identifica la proprietà di dipendenza HeaderTemplate . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
Items	Ottiene la raccolta utilizzata per generare il contenuto del controllo. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
ItemsProperty	Identifica la proprietà di dipendenza Items . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
ItemsSource	Ottiene o imposta un'origine oggetto utilizzata per generare il contenuto del controllo. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
ItemsSourceProperty	Identifica la proprietà di dipendenza ItemsSource . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
ItemTemplate	Ottiene o imposta l'oggetto DataTemplate utilizzato per visualizzare ogni elemento. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
ItemTemplateProperty	Identifica la proprietà di dipendenza ItemTemplate . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
MaxColumns	Ottiene o imposta il numero massimo di colonne in cui sono disposti i pulsanti di opzione. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
MaxColumnsProperty	Identifica la proprietà di dipendenza MaxColumns . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
SelectedIndex	Ottiene o imposta l'indice del pulsante di opzione selezionato. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
SelectedIndexProperty	Identifica la proprietà di dipendenza SelectedIndex . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
SelectedItem	Ottiene o imposta il pulsante di opzione selezionato. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
SelectedItemProperty	Identifica la proprietà di dipendenza SelectedItem . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

Metodi

ContainerFromIndex(Int32)

Restituisce il contenitore per l'elemento in corrispondenza dell'indice specificato all'interno dell'insieme di elementi. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

Eventi

SelectionChanged

Si verifica quando l'elemento attualmente selezionato viene modificato. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

Vedi anche

• Pulsanti di opzione