ColorPicker Classe

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Représente un contrôle qui permet à un utilisateur de choisir une couleur à l’aide d’un spectre de couleurs, de curseurs ou d’une entrée de texte.

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

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class ColorPicker : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class ColorPicker : Control

Public Class ColorPicker
Inherits Control

<ColorPicker .../>

Héritage

Control

ColorPicker

Attributs

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

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Sélecteur de couleurs.

Ouvrez l’application WinUI 2 Gallery et voyez le ColorPicker 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

Un sélecteur de couleur permet de parcourir et de sélectionner des couleurs. Par défaut, il permet à un utilisateur de parcourir les couleurs d’un spectre de couleurs, ou de spécifier une valeur rouge-vert-bleu (RVB), hue-saturation-value (HSV) ou une valeur de couleur hexadécimale dans une zone de texte.

Pour plus d’informations sur le contrôle ColorPicker, consultez Sélecteur de couleurs.

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

ColorPicker()

Initialise une nouvelle instance de la classe ColorPicker. 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

Color	Obtient ou définit la valeur de couleur actuelle. 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).
ColorProperty	Identifie la propriété de dépendance Color. 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).
ColorSpectrumComponents	Obtient ou définit une valeur qui indique comment les composants de couleur Hue-Saturation-Value (HSV) sont mappés au ColorSpectrum. 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).
ColorSpectrumComponentsProperty	Identifie la propriété de dépendance ColorSpectrumComponents. 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).
ColorSpectrumShape	Obtient ou définit une valeur qui indique si le ColorSpectrum est affiché sous la forme d’un carré ou d’un cercle. 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).
ColorSpectrumShapeProperty	Identifie la propriété de dépendance ColorSpectrumShape. 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).
IsAlphaEnabled	Obtient ou définit une valeur qui indique si le canal alpha peut être modifié. 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).
IsAlphaEnabledProperty	Identifie la propriété de dépendance IsAlphaEnabled. 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).
IsAlphaSliderVisible	Obtient ou définit une valeur qui indique si le contrôle de curseur pour le canal alpha est affiché. 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).
IsAlphaSliderVisibleProperty	Identifie la propriété de dépendance IsAlphaSliderVisible. 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).
IsAlphaTextInputVisible	Obtient ou définit une valeur qui indique si la zone de saisie de texte du canal alpha est affiché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).
IsAlphaTextInputVisibleProperty	Identifie la propriété de dépendance IsAlphaTextInputVisible. 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).
IsColorChannelTextInputVisible	Obtient ou définit une valeur qui indique si les zones d’entrée de texte des canaux de couleur sont affiché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).
IsColorChannelTextInputVisibleProperty	Identifie la propriété de dépendance IsColorChannelTextInputVisible. 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).
IsColorPreviewVisible	Obtient ou définit une valeur qui indique si la barre d’aperçu des couleurs est affiché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).
IsColorPreviewVisibleProperty	Identifie la propriété de dépendance IsColorPreviewVisible. 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).
IsColorSliderVisible	Obtient ou définit une valeur qui indique si le contrôle de curseur de la valeur de couleur est affiché. 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).
IsColorSliderVisibleProperty	Identifie la propriété de dépendance IsColorSliderVisible. 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).
IsColorSpectrumVisible	Obtient ou définit une valeur qui indique si le contrôle de spectre de couleurs est affiché. 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).
IsColorSpectrumVisibleProperty	Identifie la propriété de dépendance IsColorSpectrumVisible. 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).
IsHexInputVisible	Obtient ou définit une valeur qui indique si la zone de saisie de texte d’une valeur de couleur HEX est affiché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).
IsHexInputVisibleProperty	Identifie la propriété de dépendance IsHexInputVisible. 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).
IsMoreButtonVisible	Obtient ou définit une valeur qui indique si le bouton « plus » s’affiche. 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).
IsMoreButtonVisibleProperty	Identifie la propriété de dépendance IsMoreButtonVisible. 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).
MaxHue	Obtient ou définit la valeur hue maximale dans la plage 0-359. 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).
MaxHueProperty	Identifie la propriété de dépendance MaxHue. 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).
MaxSaturation	Obtient ou définit la valeur de saturation maximale dans la plage 0-100. 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).
MaxSaturationProperty	Identifie la propriété de dépendance MaxSaturation. 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).
MaxValue	Obtient ou définit la valeur valeur maximale dans la plage 0-100. 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).
MaxValueProperty	Identifie la propriété de dépendance MaxValue. 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).
MinHue	Obtient ou définit la valeur hue minimale dans la plage 0-359. 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).
MinHueProperty	Identifie la propriété de dépendance MinHue. 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).
MinSaturation	Obtient ou définit la valeur de saturation minimale dans la plage 0-100. 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).
MinSaturationProperty	Identifie la propriété de dépendance MinSaturation. 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).
MinValue	Obtient ou définit la valeur valeur minimale dans la plage 0-100. 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).
MinValueProperty	Identifie la propriété de dépendance MinValue. 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).
Orientation	Obtient ou définit l’orientation des contrôles d’édition dans ColorPicker. 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).
OrientationProperty	Identifie la propriété de dépendance Orientation . 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).
PreviousColor	Obtient ou définit la couleur précédente. 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).
PreviousColorProperty	Identifie la propriété de dépendance PreviousColor. 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

ColorChanged

Se produit lorsque la propriété Color a changé. 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

• ColorSpectrum
• Sélecteur de couleurs