RadioButtons Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

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

Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).

/// [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 informazioni, indicazioni sulla progettazione ed esempi di codice, vedere Pulsante di opzione.

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

L'app WinUI 2 Gallery 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 informazioni, indicazioni sulla progettazione e esempi di codice, vedere Pulsanti di opzione.

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

Il controllo semplifica il layout, gestisce lo spostamento della tastiera e l'accessibilità e supporta l'associazione RadioButtons a un'origine dati. Quando si usano RadioButton, è possibile considerare il gruppo di opzioni come 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 e modello di controllo

È 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, vedere Stili XAML. XAML include anche risorse che è possibile usare per modificare i colori di un controllo in diversi stati visivi senza modificare il modello di controllo. La modifica di queste risorse è preferibile impostare le proprietà, ad esempio Background e Foreground. Per altre informazioni, vedere la sezione Stile a peso leggero dell'articolo stili XAML .

Le risorse per questo controllo sono elencate nella sezione ThemeDictionaries del file RadioButtons_themeresources.xaml in GitHub. Il ResourceKey valore per ogni StaticResource riferimento a un pennello e un colore nel file Common_themeresources_any.xaml .

Costruttori

RadioButtons()

Inizializza una nuova istanza della classe RadioButtons . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).

Proprietà

Header	Ottiene o imposta il contenuto per l'intestazione del gruppo. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
HeaderProperty	Identifica la proprietà Di dipendenza Intestazione . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
HeaderTemplate	Ottiene o imposta il modello di dati usato per visualizzare il contenuto dell'intestazione del controllo. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
HeaderTemplateProperty	Identifica la proprietà di dipendenza HeaderTemplate . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
Items	Ottiene la raccolta usata per generare il contenuto del controllo. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
ItemsProperty	Identifica la proprietà di dipendenza Items . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
ItemsSource	Ottiene o imposta un'origine oggetto usata per generare il contenuto del controllo. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
ItemsSourceProperty	Identifica la proprietà di dipendenza ItemsSource . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
ItemTemplate	Ottiene o imposta l'oggetto DataTemplate usato per visualizzare ogni elemento. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
ItemTemplateProperty	Identifica la proprietà di dipendenza ItemTemplate . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
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 UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
MaxColumnsProperty	Identifica la proprietà di dipendenza MaxColumns . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
SelectedIndex	Ottiene o imposta l'indice del pulsante di opzione selezionato. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
SelectedIndexProperty	Identifica la proprietà di dipendenza SelectedIndex . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
SelectedItem	Ottiene o imposta il pulsante di opzione selezionato. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
SelectedItemProperty	Identifica la proprietà di dipendenza SelectedItem . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).

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 UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).

Eventi

SelectionChanged

Si verifica quando l'elemento attualmente selezionato cambia. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella Windows App SDK, vedere gli spazi dei nomi Windows App SDK).

Vedi anche

• Pulsanti di opzione