GetRecentItem

PowerScript function

Description

Gets the recent menu item of the application menu.

Applies to

RibbonApplicationMenu controls

Syntax

controlname.GetRecentItem ( Long Index, ref RibbonMenuItem Item )

1	controlname.GetRecentItem ( Long Index, ref RibbonMenuItem Item )

Argument	Description
controlname	The name of the RibbonApplicationMenu control from which you want to get the recent menu item.
Index	The index of the recent menu item which you want to obtain. If index is invalid, an error would occur and this operation would return -1.
Item	A RibbonMenuItem variable in which you want to store the recent menu item identified by the index.

Return value

Integer.

Returns 1 if it succeeds and -1 if an error occurs. If any
argument’s value is null, returns null.

Usage

The recent menu can have only one level and can contain no more than
9 items.

Examples

This example inserts a recent menu item “RecentItem1” and then gets
a copy of the recent menu.

Integer li_Return
Long ll_Index
RibbonApplicationMenu lr_AppMenu
RibbonMenuItem lr_MenuItem

ll_Index =  lr_AppMenu.InsertRecentItemFirst ("RecentItem1", "Ue_RecentItem1Clicked")
li_Return = lr_AppMenu.GetRecentItem (ll_Index, lr_MenuItem)