Элемент DropDownColorPicker

Статья
06/13/2023

Представляет раскрывающийся элемент управления "Выбор цвета", который при щелчке отображает палитру цветовых образцов.

Использование

<DropDownColorPicker
  CommandName = "xs:positiveInteger or xs:string"
  Columns = "xs:positiveInteger"
  ThemeColorGridRows = "xs:positiveInteger"
  StandardColorGridRows = "xs:positiveInteger"
  RecentColorGridRows = "xs:positiveInteger"
  IsAutomaticColorButtonVisible = "Boolean"
  IsNoColorButtonVisible = "Boolean"
  ColorTemplate = "xs:string"
  ChipSize = "xs:string"/>

Атрибуты

attribute	Тип	Обязательно	Описание
ChipSize	xs:string	Нет	Размер каждой цветовой микросхемы или образца. Ограничивается одним из следующих значений: (Малый) Каждая цветовая микросхема имеет квадрат 11x11 пикселей. (Средний) Каждая цветовая микросхема имеет квадрат 16x16 пикселей. (Большой) Каждая цветовая микросхема имеет квадрат 24 x 24 пикселя.
ColorTemplate	xs:string	Нет	Шаблоны макетов, указывающие тип раскрывающегося меню выбора цвета. Ограничено одним из следующих значений (если не объявлены необязательные атрибуты, связанные с ColorTemplate , отображается представление по умолчанию): (ThemeColors) По умолчанию. Задание атрибуту `ThemeColors`ColorTemplate значения включает следующие функциональные возможности: Привязка SplitButton. Кнопка "Автоматический цвет" отображается по умолчанию. Сетка образцов цветов темы Windows. Сетка эталонов стандартных цветов . Сетка "Последние цвета " является необязательной. Средство запуска диалогового окна "Дополнительные цвета". По умолчанию кнопка цвета цвета не отображается. (StandardColors) Задание атрибуту `StandardColors`ColorTemplate значения включает следующие функциональные возможности: Привязка SplitButton. Кнопка "Автоматический цвет" отображается по умолчанию. Сетка эталонов стандартных цветов . Средство запуска диалогового окна "Дополнительные цвета". По умолчанию кнопка цвета цвета не отображается. (HighlightColors) Задание атрибуту `HighlightColors`ColorTemplate значения включает следующие функциональные возможности: Привязка SplitButton. Сетка эталонов стандартных цветов без заголовка. По умолчанию кнопка цвета цвета не отображается.
Столбцы	xs:positiveInteger	Нет	Количество столбцов цветной микросхемы (или образца). (xs:positiveInteger) Любое положительное целочисленное значение от 1 до 256 включительно.
CommandName	xs:positiveInteger или xs:string	Нет	Связывает элемент с command. (xs:positiveInteger или xs:string) Строка, целочисленное значение от 2 до 59999 включительно или шестнадцатеричное значение в диапазоне от 0x2 до 0xea5f включительно. Значение должно быть уникальным в XML-документе ленты. Максимальная длина: 100 символов.
IsAutomaticColorButtonVisible	Логическое	Нет	Отображает (или скрывает) кнопку "Автоматический цвет". Допустимо только в том случае, если `StandardColors` для атрибута ColorTemplate задано значение или `ThemeColors` . Ограничено одним из следующих значений (недопустимы 0 и 1): (true) (false)
IsNoColorButtonVisible	Логическое	Нет	Отображает (или скрывает) кнопку Без цвета . Допустимо для всех значений ColorTemplate . Ограничено одним из следующих значений (недопустимы 0 и 1): (true) (false)
RecentColorGridRows	xs:positiveInteger	Нет	Количество строк цветовой микросхемы (или образца) в области Последние цвета . Допустимо только в том случае, если `ThemeColors` для атрибута ColorTemplate задано значение . (xs:positiveInteger) Любое положительное целочисленное значение от 1 до 256 включительно.
StandardColorGridRows	xs:positiveInteger	Нет	Количество строк цветовой микросхемы (или образца) в области Стандартные цвета . (xs:positiveInteger) Любое положительное целочисленное значение от 1 до 256 включительно.
ThemeColorGridRows	xs:positiveInteger	Нет	Количество строк цветовой фишки (или образца) в области Цвета темы . Допустимо только в том случае, если `ThemeColors` для атрибута ColorTemplate задано значение . (xs:positiveInteger) Любое положительное целочисленное значение от 1 до 256 включительно.

Дочерние элементы

Дочерние элементы отсутствуют.

Родительские элементы

Элемент
ControlGroup
DropDownButton
DropDownGallery
Группа
MenuGroup
SplitButton
SplitButtonGallery

Примеры

В следующем примере показана базовая разметка для всех трех типов раскрывающегося палитры.

В этом разделе кода показаны объявления command для трех элементов DropDownColorPicker .

<!-- DropDownColorPickers -->
<Command Name="cmdDropDownColorPickerGroup"
         Symbol="cmdDropDownColorPickerGroup"
         Comment="DropDownColorPicker Group"
         Id="55000"/>
<Command Name="cmdDropDownColorPickerThemeColors"
         Symbol="cmdDropDownColorPickerThemeColors"
         Comment="DropDownColorPicker ThemeColors"
         Id="55010"
         LabelTitle="ThemeColors"
         LabelDescription="ThemeColors\ndescription."/>
<Command Name="cmdDropDownColorPickerStandardColors"
         Symbol="cmdDropDownColorPickerStandardColors"
         Comment="DropDownColorPicker StandardColors"
         Id="55011"
         LabelTitle="StandardColors"/>
<Command Name="cmdDropDownColorPickerHighlightColors"
         Symbol="cmdDropDownColorPickerHighlightColors"
         Comment="DropDownColorPicker HighlightColors"
         Id="55012"
         LabelTitle="HighlightColors"/>

В этом разделе кода показаны три типа объявлений элементов управления DropDownColorPicker .

<Group CommandName="cmdDropDownColorPickerGroup"
       SizeDefinition="ThreeButtons">
  <DropDownColorPicker
    CommandName="cmdDropDownColorPickerThemeColors"
    ColorTemplate="ThemeColors"/>
  <DropDownColorPicker
    CommandName="cmdDropDownColorPickerStandardColors"
    ColorTemplate="StandardColors"/>
  <DropDownColorPicker
    CommandName="cmdDropDownColorPickerHighlightColors"
    ColorTemplate="HighlightColors"
    StandardColorGridRows="1"/>
</Group>

Сведения об элементе

Минимальная поддерживаемая система: Windows 7
Может быть пустым: Да

См. также раздел

Элемент управления "Раскрывающийся цвет"
Пример DropDownColorPicker