Поле со списком (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	Может быть обновлен только через недействительность.

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

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

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

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

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