GetRecentItem

Description

Gets the recent menu item of the application menu.

Applies to

RibbonApplicationMenu controls

Syntax

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)

See also

AddMasterSeparatorItem

ClearRecentItems

DeleteMasterItem

DeleteRecentItem

GetMasterItem

GetMasterItemCount

GetRecentItemCount

GetRecentTitle

InsertMasterItem

InsertMasterItemFirst

InsertMasterItemLast

InsertRecentItem

InsertRecentItemFirst

InsertRecentItemLast

SetMasterItem

SetRecentItem

SetRecentTitle