коллекция Drop-Down
Коллекция Drop-Down состоит из кнопки, которая при щелчке отображает раскрывающийся список, содержащий коллекцию взаимоисключающих элементов или команд.
- подробные сведения
- свойства коллекции Drop-Down
- связанные разделы
Подробности
Этот элемент управления полезен для предоставления связанных элементов или команд, где нет очевидного значения по умолчанию, а отдельные элементы могут быть представлены изображением, текстом или обоими.
Поддержка вертикальных и угловых панелей захвата или дескрипторов изменения размера предоставляется с помощью элемента DropDownGallery.MenuLayout.
На следующем снимке экрана показана коллекция Drop-Down ленты в Microsoft Paint.
Свойства коллекции Drop-Down
Платформа ленты определяет коллекцию ключей свойств для элемента управления коллекции 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 | Можно обновлять только через недопустимое обновление. |