ColorPicker 类

定义

命名空间:

Microsoft.UI.Xaml.Controls

表示允许用户使用光谱、滑块或文本输入选取颜色的控件。

本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

/// [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 .../>

继承

Control

ColorPicker

属性

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

示例

提示

有关详细信息、设计指南和代码示例，请参阅 颜色选取器。

打开 WinUI 2 库应用，查看 ColorPicker 的实际应用。

WinUI 2 库应用包括大多数 WinUI 2 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用，或在 GitHub 上获取源代码。

注解

颜色选取器用于浏览和选择颜色。 默认情况下，它允许用户浏览光谱中的颜色，或在文本框中指定红-绿-蓝 (RGB) 、Hue-饱和值 (HSV) 或十六进制颜色值。

有关 ColorPicker 控件的详细信息，请参阅 颜色选取器。

控件样式和模板

可以修改默认 的 Style 和 ControlTemplate ，使控件具有唯一的外观。 有关修改控件的样式和模板的信息，请参阅 XAML 样式。 文件中包括 generic.xaml 定义控件外观的默认样式、模板和资源。 出于设计目的， generic.xaml 随 WinUI (Microsoft.UI.Xaml) NuGet 包一起安装。 默认情况下，此位置是 \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml。 来自不同版本的 WinUI 的样式和资源可能具有不同的值。

XAML 还包括可用于在不修改控件模板的情况下修改不同视觉状态中的控件颜色的资源。 修改这些资源是首选设置属性，如 Background 和 Foreground。 有关详细信息，请参阅 XAML 样式一文的轻量级样式部分。

构造函数

ColorPicker()

初始化 ColorPicker 类的新实例。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

属性

Color	获取或设置当前颜色值。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ColorProperty	标识 Color 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ColorSpectrumComponents	获取或设置一个值，该值指示如何将 HSV) 颜色分量色调饱和度值 (映射到 ColorSpectrum。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ColorSpectrumComponentsProperty	标识 ColorSpectrumComponents 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ColorSpectrumShape	获取或设置一个值，该值指示 ColorSpectrum 是显示为正方形还是圆形。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ColorSpectrumShapeProperty	标识 ColorSpectrumShape 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsAlphaEnabled	获取或设置一个值，该值指示是否可以修改 alpha 通道。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsAlphaEnabledProperty	标识 IsAlphaEnabled 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsAlphaSliderVisible	获取或设置一个值，该值指示是否显示 alpha 通道的滑块控件。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsAlphaSliderVisibleProperty	标识 IsAlphaSliderVisible 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsAlphaTextInputVisible	获取或设置一个值，该值指示是否显示 alpha 通道的文本输入框。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsAlphaTextInputVisibleProperty	标识 IsAlphaTextInputVisible 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsColorChannelTextInputVisible	获取或设置一个值，该值指示是否显示颜色通道的文本输入框。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsColorChannelTextInputVisibleProperty	标识 IsColorChannelTextInputVisible 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsColorPreviewVisible	获取或设置一个值，该值指示是否显示颜色预览条。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsColorPreviewVisibleProperty	标识 IsColorPreviewVisible 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsColorSliderVisible	获取或设置一个值，该值指示是否显示颜色值的滑块控件。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsColorSliderVisibleProperty	标识 IsColorSliderVisible 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsColorSpectrumVisible	获取或设置一个值，该值指示是否显示光谱控件。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsColorSpectrumVisibleProperty	标识 IsColorSpectrumVisible 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsHexInputVisible	获取或设置一个值，该值指示是否显示十六进制颜色值的文本输入框。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsHexInputVisibleProperty	标识 IsHexInputVisible 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsMoreButtonVisible	获取或设置一个值，该值指示是否显示“更多”按钮。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsMoreButtonVisibleProperty	标识 IsMoreButtonVisible 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MaxHue	获取或设置 0-359 范围内的最大 Hue 值。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MaxHueProperty	标识 MaxHue 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MaxSaturation	获取或设置 0-100 范围内的最大饱和度值。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MaxSaturationProperty	标识 MaxSaturation 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MaxValue	获取或设置 0-100 范围内的最大值。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MaxValueProperty	标识 MaxValue 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MinHue	获取或设置 0-359 范围内的最小 Hue 值。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MinHueProperty	标识 MinHue 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MinSaturation	获取或设置 0-100 范围内的最小饱和度值。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MinSaturationProperty	标识 MinSaturation 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MinValue	获取或设置 0-100 范围内的最小值。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
MinValueProperty	标识 MinValue 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
Orientation	获取或设置 ColorPicker 中编辑控件的方向。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
OrientationProperty	标识 Orientation 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
PreviousColor	获取或设置以前的颜色。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
PreviousColorProperty	标识 PreviousColor 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

事件

ColorChanged

在 Color 属性更改时发生。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

另请参阅

• ColorSpectrum
• 颜色选取器