Description
Inserts a recent menu item as the first item in the application menu.
Applies to
Syntax
controlname.InsertRecentItemFirst ( String Text, String Clicked )
|
Argument |
Description |
|---|---|
|
controlname |
The RibbonApplicationMenu control in which you want to insert a recent menu item as the first item. |
|
Text |
The text that displays in the recent menu item. |
|
Clicked |
The name of the Clicked user event to be bound with the recent menu item. The Clicked user event for the recent menu item (RibbonMenuItem with "Recent(2)" type) must have two long parameters for receiving the handle of the application button and the index number of the recent menu item. For details, see Clicked. |
Return value
Long.
Returns the position of the item if it succeeds and -1 if an error occurs. If any argument's value is null, returns null.
Usage
Only the menu item with the "Recent" type (that is RibbonMenuItem with ItemType 2) can be added as a recent menu item.
The recent menu can have only one level; and can contain no more than 9 items.
The user events to be bound with the recent menu item must be defined correctly according to the requirements of RibbonMenuItem. For details, see Clicked and Selected.
Examples
This example inserts a recent menu item "RecentItem1" as the first item and binds it with the "Ue_RecentItem1Clicked" user event.
Long ll_Return
RibbonApplicationMenu lr_AppMenu
ll_Return = lr_AppMenu.InsertRecentItemFirst ("RecentItem1", "Ue_RecentItem1Clicked")
See also
