ColorPicker Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет элемент управления, позволяющий пользователю выбрать цвет с помощью цветового спектра, ползунков или текстового ввода.
Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
/// [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 : Control
Public Class ColorPicker
Inherits Control
<ColorPicker .../>
- Наследование
-
ColorPicker
- Атрибуты
-
Microsoft.UI.Xaml.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute
Примеры
Совет
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Средство выбора цвета.
Приложения из коллекции WinUI 2 включают интерактивные примеры большинства элементов управления, возможностей и функций WinUI 2. Получите приложение из Microsoft Store или получите исходный код в GitHub.
Комментарии
Палитра используется для просмотра и выбора цвета. По умолчанию он позволяет пользователю перемещаться по цветам в цветовом спектре или указывать в текстовом поле значение red-green-blue (RGB), hue-Saturation-Value (HSV) или шестнадцатеричное значение цвета.
Дополнительные сведения об элементе управления ColorPicker см. в разделе Выбор цвета.
Стиль и шаблон элемента управления
Вы можете изменить стандартные параметры Style и ControlTemplate , чтобы придать элементу управления уникальный внешний вид. Сведения об изменении стиля и шаблона элемента управления см. в разделе Стили XAML. Стиль, шаблон и ресурсы по умолчанию, определяющие внешний вид элемента управления, включаются в generic.xaml
файл . В целях generic.xaml
проектирования устанавливается вместе с пакетом NuGet WinUI (Microsoft.UI.Xaml). По умолчанию, это расположение \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml
. Стили и ресурсы из разных версий WinUI могут иметь разные значения.
XAML также включает ресурсы, которые можно использовать для изменения цветов элемента управления в различных визуальных состояниях без изменения шаблона элемента управления. Изменение этих ресурсов предпочтительнее, чем установка таких свойств, как Background и Foreground. Дополнительные сведения см. в разделе Облегчаемые стили статьио стилях XAML .
Конструкторы
ColorPicker() |
Инициализирует новый экземпляр класса ColorPicker. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
Свойства
Color |
Возвращает или задает текущее значение цвета. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
ColorProperty |
Определяет свойство зависимости Color. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
ColorSpectrumComponents |
Возвращает или задает значение, указывающее, как компоненты цвета Hue-Saturation-Value (HSV) сопоставляются с ColorSpectrum. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
ColorSpectrumComponentsProperty |
Определяет свойство зависимости ColorSpectrumComponents. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
ColorSpectrumShape |
Возвращает или задает значение, указывающее, отображается ли ColorSpectrum в виде квадрата или круга. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
ColorSpectrumShapeProperty |
Определяет свойство зависимости ColorSpectrumShape. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsAlphaEnabled |
Возвращает или задает значение, указывающее, можно ли изменить альфа-канал. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsAlphaEnabledProperty |
Определяет свойство зависимости IsAlphaEnabled. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsAlphaSliderVisible |
Возвращает или задает значение, указывающее, отображается ли элемент управления ползунок для альфа-канала. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsAlphaSliderVisibleProperty |
Определяет свойство зависимости IsAlphaSliderVisible. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsAlphaTextInputVisible |
Возвращает или задает значение, указывающее, отображается ли текстовое поле ввода для альфа-канала. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsAlphaTextInputVisibleProperty |
Определяет свойство зависимости IsAlphaTextInputVisible. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsColorChannelTextInputVisible |
Возвращает или задает значение, указывающее, отображаются ли поля текстового ввода для цветовых каналов. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsColorChannelTextInputVisibleProperty |
Определяет свойство зависимости IsColorChannelTextInputVisible. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsColorPreviewVisible |
Возвращает или задает значение, указывающее, отображается ли цветовая панель предварительного просмотра. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsColorPreviewVisibleProperty |
Определяет свойство зависимости IsColorPreviewVisible. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsColorSliderVisible |
Возвращает или задает значение, указывающее, отображается ли элемент управления ползунок для значения цвета. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsColorSliderVisibleProperty |
Определяет свойство зависимости IsColorSliderVisible. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsColorSpectrumVisible |
Возвращает или задает значение, указывающее, отображается ли элемент управления цветового спектра. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsColorSpectrumVisibleProperty |
Определяет свойство зависимости IsColorSpectrumVisible. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsHexInputVisible |
Возвращает или задает значение, указывающее, отображается ли текстовое поле ввода для шестнадцатеричного цвета. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsHexInputVisibleProperty |
Определяет свойство зависимости IsHexInputVisible. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsMoreButtonVisible |
Возвращает или задает значение, указывающее, отображается ли кнопка "дополнительно". Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
IsMoreButtonVisibleProperty |
Определяет свойство зависимости IsMoreButtonVisible. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MaxHue |
Возвращает или задает максимальное значение Hue в диапазоне от 0 до 359. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MaxHueProperty |
Определяет свойство зависимости MaxHue. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MaxSaturation |
Возвращает или задает максимальное значение насыщенности в диапазоне от 0 до 100. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MaxSaturationProperty |
Определяет свойство зависимостей MaxSaturation. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MaxValue |
Возвращает или задает максимальное значение Значения в диапазоне от 0 до 100. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MaxValueProperty |
Определяет свойство зависимостей MaxValue. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MinHue |
Возвращает или задает минимальное значение оттенка в диапазоне от 0 до 359. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MinHueProperty |
Определяет свойство зависимости MinHue. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MinSaturation |
Возвращает или задает минимальное значение насыщенности в диапазоне от 0 до 100. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MinSaturationProperty |
Определяет свойство зависимости MinSaturation. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MinValue |
Возвращает или задает минимальное значение Значения в диапазоне от 0 до 100. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
MinValueProperty |
Определяет свойство зависимости MinValue. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
Orientation |
Возвращает или задает ориентацию элементов управления редактированием в ColorPicker. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
OrientationProperty |
Определяет свойство зависимости Orientation . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
PreviousColor |
Возвращает или задает предыдущий цвет. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
PreviousColorProperty |
Определяет свойство зависимости PreviousColor. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
События
ColorChanged |
Происходит при изменении свойства Color. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |