RadioButtons Classe

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Représente un contrôle qui affiche un groupe d’options associées à partir desquelles une peut être sélectionnée.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application 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

Héritage

Control

RadioButtons

Attributs

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

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Case d’option.

Ouvrez l’application WinUI 2 Gallery et voyez radioButton en action.

L’application WinUI 2 Gallery comprend des exemples interactifs de la plupart des contrôles et fonctionnalités WinUI 2. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

Remarques

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Cases d’option.

Utilisez des cases d’option, également appelées boutons d’option, pour permettre aux utilisateurs de sélectionner une option parmi une collection de deux ou plusieurs options mutuellement exclusives, mais associées. Les cases d’option sont toujours utilisées dans des groupes, et chacune d’elles est représentée par une case d’option dans le groupe.

Le RadioButtons contrôle simplifie la disposition, gère la navigation et l’accessibilité au clavier, et prend en charge la liaison à une source de données. Lorsque vous utilisez RadioButtons, vous pouvez traiter votre groupe d’options comme une seule entité, plutôt que de suivre les contrôles RadioButton individuels.

Le contrôle RadioButtons utilise un modèle de contenu similaire à un ItemsControl. Cela signifie que vous pouvez :

• Le remplir en ajoutant des éléments directement à la collection Items ou en liant des données à sa propriété ItemsSource.
• Utiliser les propriétés SelectedIndex ou SelectedItem pour récupérer et définir l’option sélectionnée.
• Gérer l’événement SelectionChanged pour agir lorsqu’une option est choisie.

Modèle et style de contrôle

Vous pouvez modifier le Style par défaut et ControlTemplate pour donner au contrôle une apparence unique. Pour plus d’informations sur la modification du style et du modèle d’un contrôle, consultez Styles XAML. Le style, le modèle et les ressources par défaut qui définissent l’apparence du contrôle sont inclus dans le generic.xaml fichier. À des fins de conception, generic.xaml est installé avec le package NuGet WinUI (Microsoft.UI.Xaml). Par défaut, l'emplacement est \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Les styles et les ressources de différentes versions de WinUI peuvent avoir des valeurs différentes.

XAML inclut également des ressources que vous pouvez utiliser pour modifier les couleurs d’un contrôle dans différents états visuels sans modifier le modèle de contrôle. La modification de ces ressources est préférable à la définition de propriétés telles que l’arrière-plan et le premier plan. Pour plus d’informations, consultez la section Style léger de l’article Styles XAML .

Constructeurs

RadioButtons()

Initialise une nouvelle instance de la classe RadioButtons. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Propriétés

Header	Obtient ou définit le contenu de l’en-tête de groupe. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
HeaderProperty	Identifie la propriété de dépendance En-tête . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
HeaderTemplate	Obtient ou définit le modèle de données utilisé pour afficher le contenu de l’en-tête du contrôle. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
HeaderTemplateProperty	Identifie la propriété de dépendance HeaderTemplate . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Items	Obtient la collection utilisée pour générer le contenu du contrôle. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ItemsProperty	Identifie la propriété de dépendance Items . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ItemsSource	Obtient ou définit une source d’objet utilisée pour générer le contenu du contrôle. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ItemsSourceProperty	Identifie la propriété de dépendance ItemsSource . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ItemTemplate	Obtient ou définit le DataTemplate utilisé pour afficher chaque élément. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ItemTemplateProperty	Identifie la propriété de dépendance ItemTemplate . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MaxColumns	Obtient ou définit le nombre maximal de colonnes dans lesquelles les cases d’option sont organisées. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MaxColumnsProperty	Identifie la propriété de dépendance MaxColumns . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SelectedIndex	Obtient ou définit l’index de la case d’option sélectionnée. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SelectedIndexProperty	Identifie la propriété de dépendance SelectedIndex . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SelectedItem	Obtient ou définit la case d’option sélectionnée. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SelectedItemProperty	Identifie la propriété de dépendance SelectedItem . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Méthodes

ContainerFromIndex(Int32)

Retourne le conteneur de l’élément à l’index spécifié dans la collection d’éléments. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Événements

SelectionChanged

Se produit lorsque l’élément actuellement sélectionné change. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Voir aussi

• Cases d’option