Коллекция Drop-Down

  • Статья

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

Сведения

Этот элемент управления полезен для предоставления связанных элементов или команд, где нет очевидного значения по умолчанию, а отдельные элементы могут быть представлены изображением, текстом или и тем, и другим.

Поддержка вертикальных и угловых отрезков захвата или маркеров изменения размера обеспечивается с помощью элемента DropDownGallery.MenuLayout .

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

Снимок экрана: раскрывающийся список элементов управления на ленте Microsoft Paint.

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

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

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

Примечание

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

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

Ключ свойства Примечания
UI_PKEY_Categories Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_Enabled Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_ItemsSource Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip Может быть обновлен только через недействительность.
UI_PKEY_Label Может быть обновлен только через недействительность.
UI_PKEY_LargeHighContrastImage Может быть обновлен только через недействительность.
UI_PKEY_LargeImage Может быть обновлен только через недействительность.
UI_PKEY_SelectedItem(допустимо только для коллекции элементов)
 Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty. Примечание: Если команда, связанная с элементом управления, становится недействительной в результате вызова IUIFramework::InvalidateUICommand, платформа запрашивает это свойство при UI_INVALIDATIONS_VALUE передаче в качестве значения флагов.
UI_PKEY_SmallHighContrastImage Может быть обновлен только через недействительность.
UI_PKEY_SmallImage Может быть обновлен только через недействительность.
UI_PKEY_TooltipDescription Может быть обновлен только через недействительность.
UI_PKEY_TooltipTitle Может быть обновлен только через недействительность.

Библиотека элементов управления Windows Ribbon Framework

Элемент разметки DropDownGallery

Работа с коллекциями

Пример коллекции