ColorPicker Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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).
/// [Microsoft.UI.Xaml.MUXContractProperty(version=5)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class ColorPicker : Control/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=5)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class ColorPicker : Control[Microsoft.UI.Xaml.MUXContractProperty(version=5)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class ColorPicker : Control[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=5)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
public 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 : ControlPublic Class ColorPicker
Inherits Control<ColorPicker .../>
- Herencia
-
ColorPicker
- Atributos
-
Microsoft.UI.Xaml.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute 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.
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). |