Partager via


RadioButtons Classe

Définition

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.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
Héritage
RadioButtons
Attributs
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContentPropertyAttribute ContractVersionAttribute

Exemples

Conseil

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

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.

Exemple de groupe RadioButtons avec une case d’option sélectionnée

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

S’applique à

Voir aussi