Кнопка Drop-Down
Кнопка Drop-Down состоит из кнопки, которая при нажатии отображает раскрывающийся список взаимоисключающих элементов.
Сведения
Этот элемент управления полезен для предоставления тесно связанных элементов в тех случаях, когда не существует очевидного значения по умолчанию и когда отдельные элементы могут быть представлены изображением, текстом или и тем, и другим.
На следующем снимке экрана показана кнопка Drop-Down ленты в примере ленты.
Свойства кнопки Drop-Down
Платформа ленты определяет коллекцию ключей свойств для элемента управления Drop-Down Button.
Как правило, свойство Drop-Down Button обновляется в пользовательском интерфейсе ленты путем отмены команды, связанной с элементом управления, путем вызова метода IUIFramework::InvalidateUICommand . Событие недействительности обрабатывается и свойство обновляется с помощью метода обратного вызова IUICommandHandler::UpdateProperty .
Метод обратного вызова IUICommandHandler::UpdateProperty не выполняется, и приложение запрашивает обновленное значение свойства, пока свойство не потребуется для платформы. Например, при активации вкладки и отображении элемента управления в пользовательском интерфейсе ленты или при отображении подсказки.
Примечание
В некоторых случаях свойство можно получить с помощью метода IUIFramework::GetUICommandProperty и задать с помощью метода IUIFramework::SetUICommandProperty .
В следующей таблице перечислены ключи свойств, связанные с элементом управления Drop-Down Button.
| Ключ свойства | Примечания |
|---|---|
| UI_PKEY_Categories | Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty. |
| UI_PKEY_Enabled | Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty. Если все дочерние элементы отключены, платформа задает для UI_PKEY_Enabled значение false (0). В противном случае, если включен один или несколько дочерних элементов, UI_PKEY_Enabled имеет значение true (-1). Внимание! Свойство UI_PKEY_Enabled элемента управления Drop-Down Button должно быть недействительным после включения или отключения одного или нескольких дочерних элементов. Это гарантирует, что платформа запрашивает обновленное значение свойства и обновляет состояние элемента управления Drop-Down Button в пользовательском интерфейсе ленты. |
| 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 | Может быть обновлен только через недействительность. |