Средство выбора цвета Drop-Down

Статья
06/13/2023

Платформа ленты Windows предоставляет специализированный Drop-Down элемент управления "Выбор цвета", который предоставляет различные параметры цвета с помощью кнопки разделения и настраиваемого раскрывающегося селектора цветов.

Введение
разметку
Код
- Свойства
- Обработчики команд
Связанные темы

Введение

Эмулируя внешний вид и функциональные возможности средства выбора цветов Microsoft Office, платформа ленты может использовать преимущества согласованности и знакомство с различными приложениями, а также способствовать их повышению.

разметку

Как и все элементы управления ленты, средство выбора цвета Drop-Down легко реализуется и настраивается с помощью разметки. Платформа предоставляет ряд атрибутов элементов для средства выбора цвета Drop-Down для предоставления различных уровней функциональности. В следующей таблице перечислены Drop-Down атрибуты средства выбора цвета.

attribute	Описание
ColorTemplate	Шаблоны макетов, указывающие тип Drop-Down палитры. Существует три шаблона, каждый из которых задает макет элемента управления и значения по умолчанию для связанных атрибутов и ключей свойств. `ThemeColors` `StandardColors` `HighlightColors`
ChipSize	Размер каждой цветовой микросхемы (или образца). `Small` `Medium` `Large`
Столбцы	Количество столбцов цветной микросхемы (или образца).
CommandName	Имя связанного объявления command.
IsAutomaticColorButtonVisible	Отображает (или скрывает) кнопку Автоматически . Допустимо, только если ColorTemplate имеет значение `ThemeColors` или `StandardColors`.
IsNoColorButtonVisible	Отображает (или скрывает) кнопку Без цвета . Допустимо для всех значений ColorTemplate .
RecentColorGridRows	Количество строк цветовой микросхемы (или образца) в области Последние цвета . Допустимо, только если ColorTemplate имеет значение `ThemeColors`.
StandardColorGridRows	Количество строк цветовой микросхемы (или образца) в области Стандартные цвета .
ThemeColorGridRows	Количество строк цветовой фишки (или образца) в области Цвета темы . Допустимо, только если ColorTemplate имеет значение `ThemeColors`.

На следующих снимках экрана показаны макеты по умолчанию Drop-Down палитры для трех шаблонов цветов.


`ThemeColors`Снимок экрана:[newline] [новая строка]	`standardcolors`Снимок экрана:[newline] [новая строка]	`highlightcolors`Снимок экрана:[newline]

Базовая разметка, необходимая для каждого типа Drop-Down палитры, показана в следующих примерах:

Примечание

Выбор цвета Drop-Down является допустимым элементом управления Кнопка в шаблоне SizeDefinition .

<!-- 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"/>


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

Код

Как специализированный элемент управления, поддерживающий настройку, любая реализация Drop-Down Color Picker, использующее эти возможности, требует специального кода приложения для управления свойствами и обработки любых команд, выдаваемых элементом управления .

Свойства

Платформа ленты определяет коллекцию ключей свойств для элемента управления Drop-Down Color Picker.

Как правило, свойство выбора цвета Drop-Down обновляется в пользовательском интерфейсе ленты путем аннулирования команды, связанной с элементом управления, с помощью вызова метода IUIFramework::InvalidateUICommand . Событие недействительности обрабатывается и свойство обновляется с помощью метода обратного вызова IUICommandHandler::UpdateProperty .

Метод обратного вызова IUICommandHandler::UpdateProperty не выполняется, и приложение запросит обновленное значение свойства, пока свойство не потребуется платформе. Например, при активации вкладки и отображении элемента управления в пользовательском интерфейсе ленты или при отображении подсказки.

Примечание

В некоторых случаях свойство можно получить с помощью метода IUIFramework::GetUICommandProperty и задать с помощью метода IUIFramework::SetUICommandProperty .

В следующей таблице перечислены ключи свойств, связанные с элементом управления Drop-Down Color Picker.

Ключ свойства	Описание	Примечания
UI_PKEY_AutomaticColorLabel	Определяет метку для кнопки "Автоматический цвет". Допустимо только в том случае , если ColorTemplate имеет значение `ThemeColors` или `StandardColors`.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_Color	Определяет выбранное значение цвета в виде COLORREF. Допустимо только в том случае, если UI_PKEY_ColorType имеет значение `UI_SWATCHCOLORTYPE_RGB`.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_ColorType	Определяет выбранный тип цвета.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_Enabled	Определяет возможность реагирования элемента управления на взаимодействие с пользователем.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip	Может быть обновлено только через недействительность.
UI_PKEY_Label	Определяет строку символов для метки элемента управления.	Может быть обновлено только через недействительность.
UI_PKEY_LargeHighContrastImage	Определяет большое высококонтрастное изображение, отображаемое для элемента управления .	Может быть обновлено только через недействительность. Дополнительные сведения о форматах изображений см. в разделе Указание ресурсов изображений ленты.
UI_PKEY_LargeImage	Определяет большое изображение, отображаемое для элемента управления.	Может быть обновлено только через недействительность. Дополнительные сведения о форматах изображений см. в разделе Указание ресурсов изображений ленты.
UI_PKEY_MoreColorsLabel	Определяет метку для кнопки Дополнительные цвета. Допустимо только в том случае , если ColorTemplate имеет значение `ThemeColors` или `StandardColors`.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_NoColorLabel	Определяет метку для кнопки Без цвета . Допустимо для всех значений ColorTemplate .	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_RecentColorsCategoryLabel	Определяет метку для категории Последние цвета . Допустимо только в том случае , если ColorTemplate имеет значение `ThemeColors`. Это единственный шаблон, содержащий помеченные категории.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_SmallHighContrastImage	Определяет небольшое изображение с высокой контрастностью, отображаемое для элемента управления .	Может быть обновлено только через недействительность. Дополнительные сведения о форматах изображений см. в разделе Указание ресурсов изображений ленты.
UI_PKEY_SmallImage	Определяет небольшое изображение, отображаемое для элемента управления .	Может быть обновлено только через недействительность. Дополнительные сведения о форматах изображений см. в разделе Указание ресурсов изображений ленты.
UI_PKEY_StandardColors	Определяет массив значений COLORREF для образцов Drop-Down палитры. Каждая Drop-Down ColorTemplate палитры содержит сетку `StandardColors` . Примечание: Отображаются значения COLORREF из исходного столбца StandardColorGridRows x массива. Если массив определяет меньше цветов, чем количество образцов, объявленных `StandardColors` в разметке, для отсутствующих чипов отображаются пустые пробелы.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_StandardColorsCategoryLabel	Определяет метку для категории Стандартные цвета . Допустимо только в том случае , если ColorTemplate имеет значение `ThemeColors`. Это единственный шаблон, содержащий помеченные категории.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_StandardColorsTooltips	Определяет массив строк с подсказками цветовой палитры для сетки `StandardColors` . Каждая Drop-Down ColorTemplate палитры содержит сетку `StandardColors` . Примечание: Используются только подсказки, необходимые для маркировки цветовых образцов, отображаемых в сетке `StandardColors` . Если указано меньше меток, чем количество образцов в сетке `StandardColors` , для остальных образцов предоставляется значение по умолчанию.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_ThemeColors	Определяет массив значений COLORREF для образцов Drop-Down палитры. Допустимо только в том случае , если ColorTemplate имеет значение `ThemeColors`. Примечание: Отображаются значения COLORREF из исходного столбца ThemeColorGridRows x массива. Если массив определяет меньше цветов, чем количество образцов, объявленных `ThemeColors` в разметке, для отсутствующих чипов отображаются пустые пробелы.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_ThemeColorsTooltips	Определяет массив строк с подсказками цветовой палитры для сетки `ThemeColors` . Допустимо только в том случае , если ColorTemplate имеет значение `ThemeColors`. Примечание: Используются только подсказки, необходимые для маркировки цветовых образцов, отображаемых в сетке `ThemeColors` . Если указано меньше меток, чем количество образцов в сетке `ThemeColors` , для остальных образцов предоставляется значение по умолчанию.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_ThemeColorsCategoryLabel	Определяет метку для категории Цвета темы . Допустимо только в том случае , если ColorTemplate имеет значение `ThemeColors`. Это единственный шаблон, содержащий помеченные категории.	Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_TooltipDescription	Определяет строку символов для описания подсказки, связанной с UI_PKEY_TooltipTitle.	Может быть обновлено только через недействительность.
UI_PKEY_TooltipTitle	Определяет строку символов для подсказки команды.	Может быть обновлено только через недействительность.

Обработчики команд

Метод IUICommandHandler::UpdateProperty используется для настройки Drop-Down палитры с помощью перечисленных выше ключей свойств. В следующем примере показано, как задать цветовые образцы Drop-Down палитры на основе предпочтений пользовательского стиля или настраиваемой сетки образцов, объявленной в разметке.

STDMETHODIMP DropDownColorPickerHandler::UpdateProperty(
              UINT nCmdID,
              __in REFPROPERTYKEY key,
              __in_opt const PROPVARIANT* ppropvarCurrentValue,
              __out PROPVARIANT* ppropvarNewValue)
{
  HRESULT hr = E_NOTIMPL;
  if (key == UI_PKEY_ThemeColors)
  {
    COLORREF rThemeColors[TOT_THEME_COLORS];
    for (LONG i = 0; i < ARRAYSIZE(rThemeColors); i++)
    {
      // any COLORREF
      rThemeColors[i] = RGB(0, 255, 0); 
    }
    hr = InitPropVariantFromUInt32Vector(
           &rThemeColors, ARRAYSIZE(rThemeColors), ppropvarNewValue);
  }

  else if (key == UI_PKEY_StandardColors)
  {
    ULONG rStandardColors[TOT_STANDARD_COLORS];
    for (LONG i = 0; i < ARRAYSIZE(rStandardColors); i++)
    {
      // any COLORREF
      rStandardColors[i] = RGB(255, 0, 0); 
    }
    hr = InitPropVariantFromUInt32Vector(
           &rStandardColors, ARRAYSIZE(rStandardColors),ppropvarNewValue);
  }

  else if (key == UI_PKEY_ThemeColorsTooltips)
  {
    BSTR rThemeTooltips[TOT_THEME_COLORS];
    for (LONG i = 0; i < ARRAYSIZE(rThemeTooltips); i++)
    {
      // any constant character string
      rThemeTooltips[i] = L"Green"; 
    }
    hr = InitPropVariantFromStringVector((PCWSTR *)&rThemeTooltips, 50, ppropvarNewValue);
  }
  else if (key == UI_PKEY_StandardColorsTooltips)
  {
    static BSTR rStandardTooltips[TOT_STANDARD_COLORS];
    for (LONG i = 0; i < ARRAYSize(rStandardTooltips); i++)
    {
      // any constant character string
      rStandardTooltips[i] = L"Red"; 
    }
    hr = InitPropVariantFromStringVector(
           (PCWSTR *)&rStandardTooltips, 20, ppropvarNewValue);
  }
  return hr;
}

В следующем примере показана реализация метода IUICommandHandler::Execute , который предоставляет Drop-Down цвета палитры выбора цвета для приложения ленты.

STDMETHODIMP DropDownColorPickerHandler::Execute(
                 UINT nCmdID,
                 UI_EXECUTIONVERB verb,
                 __in_opt const PROPERTYKEY* key,
                 __in_opt const PROPVARIANT* ppropvarValue,
                 __in_opt IUISimplePropertySet* pCommandExecutionProperties)
{
  HRESULT hr = E_NOTIMPL;
  if (*key == UI_PKEY_ColorType)
  {
    UI_SWATCHCOLORTYPE uType = 
      (UI_SWATCHCOLORTYPE)PropVariantToUInt32WithDefault(
        *ppropvarValue, 
        UI_SWATCHCOLORTYPE_NOCOLOR);

    COLORREF color;
    switch(uType)
    {
      case UI_SWATCHCOLORTYPE_RGB:
        PROPVARIANT var;
        pCommandExecutionProperties->GetValue(UI_PKEY_Color, &var);
        color = PropVariantToUInt32WithDefault(var, 0);
        break;
      case UI_SWATCHCOLORTYPE_AUTOMATIC:
        color = COLOR_WINDOWTEXT;
        break;
      case UI_SWATCHCOLORTYPE_NOCOLOR:
        color = MSONoFill;
        break;
    }

    // do with your color what you will...
    gInternalColor = color;
    hr = S_OK;
  }
  return hr;
}

Библиотека элементов управления Windows Ribbon Framework
Элемент разметки DropDownColorPicker
Свойства палитры
Настройка ленты с помощью определений размера и политик масштабирования
Пример DropDownColorPicker

Поделиться через

Средство выбора цвета Drop-Down

Введение

разметку

Код

Свойства

Обработчики команд

Обратная связь

Дополнительные ресурсы

Поделиться через

Средство выбора цвета Drop-Down

Введение

разметку

Код

Свойства

Обработчики команд

Связанные темы

Обратная связь

Дополнительные ресурсы