Поле со списком (Windows Ribbon Framework)
Поле со списком состоит из списка из одного столбца, содержащего коллекцию взаимоисключающих элементов или команд в сочетании со статическим элементом управления или элементом управления "Изменить" и стрелкой раскрывающегося списка. Часть списка элемента управления отображается, когда пользователь щелкает стрелку раскрывающегося списка.
Сведения
Выбранный в данный момент элемент или команда (при наличии) в списке отображается в элементе управления "Статический" или "Изменить". В элементе управления редактированием, если пользователь вводит начальные символы существующего элемента или команды, поле списка выделяет первый элемент с этими начальными символами и автоматически заполняет запись в элементе управления редактированием.
Поддерживает только вертикальную полосу захвата или маркер изменения размера.
Этот элемент управления полезен для предоставления простых, тесно связанных текстовых элементов.
На следующем снимке экрана показана лента со списком в Live Movie Maker.
Свойства поля со списком
Платформа ленты определяет коллекцию ключей свойств для элемента управления Поле со списком.
Как правило, свойство Поля со списком обновляется в пользовательском интерфейсе ленты путем отмены команды, связанной с элементом управления, путем вызова метода IUIFramework::InvalidateUICommand . Событие недействительности обрабатывается и свойство обновляется с помощью метода обратного вызова IUICommandHandler::UpdateProperty .
Метод обратного вызова IUICommandHandler::UpdateProperty не выполняется, и приложение запрашивает обновленное значение свойства, пока свойство не потребуется для платформы. Например, при активации вкладки и отображении элемента управления в пользовательском интерфейсе ленты или при отображении подсказки.
Примечание
В некоторых случаях свойство можно получить с помощью метода IUIFramework::GetUICommandProperty и задать с помощью метода IUIFramework::SetUICommandProperty .
В следующей таблице перечислены ключи свойств, связанные с элементом управления Поле со списком.
| Ключ свойства | Примечания |
|---|---|
| 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. |
| UI_PKEY_SmallHighContrastImage | Может быть обновлен только через недействительность. |
| UI_PKEY_SmallImage | Может быть обновлен только через недействительность. |
| UI_PKEY_StringValue | Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
Примечание: Если команда, связанная с элементом управления, становится недействительной в результате вызова IUIFramework::InvalidateUICommand, платформа запрашивает это свойство при UI_INVALIDATIONS_VALUE передаче в качестве значения флагов. |
| UI_PKEY_TooltipDescription | Может быть обновлен только через недействительность. |
| UI_PKEY_TooltipTitle | Может быть обновлен только через недействительность. |