Недавние элементы
Список Последние элементы — это панель в меню приложения , в котором отображаются последние использованные элементы (MRU) для приложения.
Сведения
На следующем снимке экрана показан список последних элементов из WordPad для Windows 7.
Меню приложения может содержать не более одного списка ApplicationMenu.RecentItems, представленного элементом ApplicationMenu.RecentItems, для отображения последних документов, изображений, фильмов и других проектов, над которыми работал пользователь. Количество перечисленных элементов колеблется от нуля до максимального числа, указанного в разметке, со значением по умолчанию десять. Последние элементы отображаются в виде нумерованного списка строк, указывающих имена файлов. Рекомендуется использовать свойство Command.LabelDescription , чтобы указать полный путь к расположению файла, как показано на следующем снимке экрана.
Элемент RecentItems имеет атрибут EnablePinning , который, если задано значение true, отображает значок закрепления справа от каждого элемента в списке, как показано на следующем снимке экрана.
Примечание
Закрепление включено по умолчанию, если атрибут EnablePinning не указан.
Алгоритм закрепления предназначен для того, чтобы элементы не упадали из списка Последние элементы . Алгоритм создает следующее поведение:
- Новый элемент всегда добавляется в начало списка Последние элементы .
- Элементы будут перемещаться вниз в списке со временем. После заполнения списка (достижения максимального количества элементов, указанного в разметке), старые элементы выпадают из нижней части списка, так как новые элементы добавляются в начало списка.
- Если элемент уже отображается в списке, но к нему снова обращается, он перемещается обратно в начало списка.
- Если элемент закреплен, он по-прежнему будет перемещаться вниз по списку, но не будет падать снизу. Вместо этого после заполнения списка первый незакрепленный элемент над закрепленным элементом отпадает при добавлении нового элемента в список.
- Если количество закрепленных элементов когда-либо достигает максимального числа элементов, новые элементы не будут добавлены в список, пока элемент не будет откреплен.
Свойства последних элементов
Платформа ленты определяет коллекцию ключей свойств для элемента управления Последние элементы.
Как правило, свойство Recent Items обновляется в пользовательском интерфейсе ленты путем отмены команды, связанной с элементом управления, путем вызова метода IUIFramework::InvalidateUICommand . Событие недействительности обрабатывается и свойство обновляется с помощью метода обратного вызова IUICommandHandler::UpdateProperty .
Метод обратного вызова IUICommandHandler::UpdateProperty не выполняется, и приложение запросит обновленное значение свойства, пока свойство не потребуется платформе. Например, при активации вкладки и отображении элемента управления в пользовательском интерфейсе ленты или при отображении подсказки.
Примечание
В некоторых случаях свойство можно получить с помощью метода IUIFramework::GetUICommandProperty и задать с помощью метода IUIFramework::SetUICommandProperty .
В следующей таблице перечислены ключи свойств, связанные с элементом управления Последние элементы.
| Ключ свойства | Примечания |
|---|---|
| UI_PKEY_Keytip | Может быть обновлено только через недействительность. |
| UI_PKEY_RecentItems | Может быть обновлено только через недействительность. |
Комментарии
Метод IApplicationDocumentLists::GetList можно использовать для получения списка MRU оболочки Windows для приложения ленты. Затем объект, полученный этим методом, может использоваться приложением для создания данных, необходимых платформе ленты для заполнения списка Последние элементыменю приложения.
Примечание
При использовании этого метода listtype должен иметь значение ADLT_RECENT.
Пример реализации списка элементов MRU в приложении платформы ленты см. в примере HTMLEditRibbon.
Связанные темы