ColorPicker Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

Representa un control que permite a un usuario elegir un color mediante un espectro de colores, controles deslizantes o entrada de texto.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para 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 .../>

Herencia

Control

ColorPicker

Atributos

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

Ejemplos

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Selector de colores.

Abra la aplicación Galería de WinUI 2 y vea ColorPicker en acción.

La aplicación WinUI 2 Gallery incluye ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 2. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.

Comentarios

Un selector de colores se usa para explorar y seleccionar colores. De forma predeterminada, permite al usuario navegar por colores en un espectro de colores, o especificar un valor de color Rojo-Verde-Azul (RGB), Valor de saturación de hue (HSV) o color hexadecimal en un cuadro de texto.

Para obtener más información sobre el control ColorPicker, consulta Selector de colores.

Estilo de control y plantilla

Puede modificar el estilo predeterminado y controlTemplate para proporcionar al control una apariencia única. Para obtener información sobre cómo modificar el estilo y la plantilla de un control, consulta Estilos XAML. El estilo, la plantilla y los recursos predeterminados que definen la apariencia del control se incluyen en el generic.xaml archivo . Para fines de diseño, generic.xaml se instala con el paquete NuGet WinUI (Microsoft.UI.Xaml). De forma predeterminada, la ubicación es \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Los estilos y recursos de diferentes versiones de WinUI pueden tener valores diferentes.

XAML también incluye recursos que puedes usar para modificar los colores de un control en diferentes estados visuales sin modificar la plantilla de control. Se prefiere modificar estos recursos para establecer propiedades como Background y Foreground. Para obtener más información, consulta la sección Estilo ligero del artículo Estilos XAML .

Constructores

ColorPicker()

Inicializa una nueva instancia de la clase ColorPicker. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Propiedades

Color	Obtiene o establece el valor de color actual. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
ColorProperty	Identifica la propiedad de dependencia Color. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
ColorSpectrumComponents	Obtiene o establece un valor que indica cómo se asignan los componentes de color Hue-Saturación-Valor (HSV) a ColorSpectrum. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
ColorSpectrumComponentsProperty	Identifica la propiedad de dependencia ColorSpectrumComponents. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
ColorSpectrumShape	Obtiene o establece un valor que indica si ColorSpectrum se muestra como un cuadrado o un círculo. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
ColorSpectrumShapeProperty	Identifica la propiedad de dependencia ColorSpectrumShape. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsAlphaEnabled	Obtiene o establece un valor que indica si se puede modificar el canal alfa. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsAlphaEnabledProperty	Identifica la propiedad de dependencia IsAlphaEnabled. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsAlphaSliderVisible	Obtiene o establece un valor que indica si se muestra el control deslizante del canal alfa. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsAlphaSliderVisibleProperty	Identifica la propiedad de dependencia IsAlphaSliderVisible. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsAlphaTextInputVisible	Obtiene o establece un valor que indica si se muestra el cuadro de entrada de texto para el canal alfa. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsAlphaTextInputVisibleProperty	Identifica la propiedad de dependencia IsAlphaTextInputVisible. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsColorChannelTextInputVisible	Obtiene o establece un valor que indica si se muestran los cuadros de entrada de texto para los canales de color. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsColorChannelTextInputVisibleProperty	Identifica la propiedad de dependencia IsColorChannelTextInputVisible. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsColorPreviewVisible	Obtiene o establece un valor que indica si se muestra la barra de vista previa de color. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsColorPreviewVisibleProperty	Identifica la propiedad de dependencia IsColorPreviewVisible. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsColorSliderVisible	Obtiene o establece un valor que indica si se muestra el control deslizante para el valor de color. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsColorSliderVisibleProperty	Identifica la propiedad de dependencia IsColorSliderVisible. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsColorSpectrumVisible	Obtiene o establece un valor que indica si se muestra el control de espectro de colores. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsColorSpectrumVisibleProperty	Identifica la propiedad de dependencia IsColorSpectrumVisible. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsHexInputVisible	Obtiene o establece un valor que indica si se muestra el cuadro de entrada de texto para un valor de color HEX. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsHexInputVisibleProperty	Identifica la propiedad de dependencia IsHexInputVisible. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsMoreButtonVisible	Obtiene o establece un valor que indica si se muestra el botón "más". Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsMoreButtonVisibleProperty	Identifica la propiedad de dependencia IsMoreButtonVisible. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MaxHue	Obtiene o establece el valor máximo de Hue en el intervalo 0-359. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MaxHueProperty	Identifica la propiedad de dependencia MaxHue. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MaxSaturation	Obtiene o establece el valor de saturación máximo en el intervalo 0-100. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MaxSaturationProperty	Identifica la propiedad de dependencia MaxSaturation. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MaxValue	Obtiene o establece el valor de valor máximo en el intervalo 0-100. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MaxValueProperty	Identifica la propiedad de dependencia MaxValue. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MinHue	Obtiene o establece el valor de Hue mínimo en el intervalo 0-359. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MinHueProperty	Identifica la propiedad de dependencia MinHue. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MinSaturation	Obtiene o establece el valor de saturación mínimo en el intervalo 0-100. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MinSaturationProperty	Identifica la propiedad de dependencia MinSaturation. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MinValue	Obtiene o establece el valor de valor mínimo en el intervalo 0-100. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MinValueProperty	Identifica la propiedad de dependencia MinValue. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
Orientation	Obtiene o establece la orientación de los controles de edición en ColorPicker. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
OrientationProperty	Identifica la propiedad de dependencia Orientation . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
PreviousColor	Obtiene o establece el color anterior. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
PreviousColorProperty	Identifica la propiedad de dependencia PreviousColor. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Eventos

ColorChanged

Se produce cuando la propiedad Color ha cambiado. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Consulte también

• ColorSpectrum
• Selector de colores