RecentItems element

Represents the Recent Items control in the Application Menu.

Usage

<RecentItems
  CommandName = "xs:positiveInteger or xs:string"
  MaxCount = "xs:nonNegativeInteger"
  EnablePinning = "Boolean"/>

Attributes

Attribute Type Required Description
CommandName
xs:positiveInteger or xs:string
No
Associates the element with a Command.

(xs:positiveInteger or xs:string)
A string, an integer value between 2 and 59999, inclusive, or a hexadecimal value between 0x2 and 0xea5f, inclusive.
The value must be unique within the Ribbon XML document.
Maximum length: 100 characters.
EnablePinning
Boolean
No
Restricted to one of the following values (0 and 1 are not valid):

(true)
Default.
(false)
MaxCount
xs:nonNegativeInteger
No
The number of recent items to display.

(xs:nonNegativeInteger)
An integer value of 0 or greater.
Default is 10.

Child elements

There are no child elements.

Parent elements

Element
ApplicationMenu.RecentItems

Remarks

Required.

Must occur exactly once for each ApplicationMenu.RecentItems element.

The Recent Items control displays the most recently used (MRU) items list of the Ribbon application.

Examples

The following example demonstrates the basic markup for the Recent Items control.

The following example shows a RecentItems Command declaration.

<!-- Command declaration for most recently used items. -->
<Command Name="cmdMRUItems"
         Symbol="ID_FILE_MRUITEMS"
         Id="25050"/>

The following example shows the associated RecentItems controls declaration.

<!-- Most recently used items collection. -->
<ApplicationMenu.RecentItems>
  <RecentItems CommandName="cmdMRUItems"/>
</ApplicationMenu.RecentItems>

Element information

  • Minimum supported system: Windows 7
  • Can be empty: Yes

See also

Application Menu control

Recent Items control