Recent Items

The Recent Items list is a pane in the Application Menu that displays the most recently used (MRU) items for an application.

Details

The following screen shot illustrates a Recent Items list from WordPad for Windows 7).

screen shot of the recent items list in the microsoft paint ribbon.

The Application Menu can have at most one ApplicationMenu.RecentItems list, represented by an ApplicationMenu.RecentItems element, for displaying recent documents, pictures, movies, and other projects a user has been working on. The number of listed items ranges from zero to the maximum number specified in markup, with a default value of ten. The recent items are displayed as a numbered list of strings indicating file names. It is recommended that the Command.LabelDescription property be used to give the full path for the file location, as shown in the following screen shot .

screen shot of a recent items list in an application menu.

The RecentItems element has an EnablePinning attribute that, if set to true, displays a pin icon to the right of each item in the list, as shown in the following screen shot.

Note

Pinning is enabled by default if the EnablePinning attribute is not specified.

 

screen shot of recent items pinning in an application menu.

The pinning algorithm is intended to keep items from falling off the Recent items list. The algorithm produces the following behavior:

  • A new item is always added at the top of the Recent items list.
  • Items will move down in the list over time. Once the list is full (reaches the maximum number of items specified in markup), older items fall off the bottom of the list as new items are added to the top of the list.
  • If an item already appears somewhere in the list but is accessed again, it moves back to the top of the list.
  • If an item is pinned, it will still travel down the list, but it will not fall off the bottom. Instead, once the list is full, the first unpinned item above the pinned item will fall off when a new item is added to the list.
  • If the number of pinned items ever reaches the maximum number of items, then no new items will get added to the list until an item is unpinned.

Recent Items Properties

The Ribbon framework defines a collection of property keys for the Recent Items control.

Typically, a Recent Items property is updated in the ribbon UI by invalidating the Command associated with the control through a call to the IUIFramework::InvalidateUICommand method. The invalidation event is handled, and the property updates defined, by the IUICommandHandler::UpdateProperty callback method.

The IUICommandHandler::UpdateProperty callback method is not executed, and the application queried for an updated property value, until the property is required by the framework. For example, when a tab is activated and a control revealed in the ribbon UI, or when a tooltip is displayed.

Note

In some cases, a property can be retrieved through the IUIFramework::GetUICommandProperty method and set with the IUIFramework::SetUICommandProperty method.

 

The following table lists the property keys that are associated with the Recent Items control.

Property Key Notes
UI_PKEY_Keytip Can only be updated through invalidation.
UI_PKEY_RecentItems Can only be updated through invalidation.

 

Remarks

The IApplicationDocumentLists::GetList method can be used to retrieve the Windows Shell MRU list for the Ribbon application. The object retrieved by this method can then be used by the application to create the data required by the Ribbon framework to populate the Recent items list of the Application Menu.

Note

When using this method, listtype should have the value ADLT_RECENT.

 

For an example of how to implement an MRU items list in a Ribbon framework application, see the HTMLEditRibbon Sample.

Windows Ribbon Framework Control Library

Recent items markup element