A RibbonApplicationMenu control defines an application menu which can be associated with the application button (RibbonApplicationButtonItem) in the RibbonBar control. The application menu is the main menu of your application; it contains a master menu and a recent menu. For more about the application menu, see the section called “Introduction to RibbonBar items” in Users Guide.
The RibbonApplicationMenu control is the child object of the RibbonApplicationButtonItem control, and is the parent object of the RibbonMenuItem control: RibbonBar > ApplicationButton > ApplicationMenu > MenuItem. For the hierarchical structure of the ribbon item controls and how to get and set them, refer to the section called “Accessing the RibbonBar items via PowerScripts” in Users Guide.
RibbonApplicationMenu property |
Datatype |
Description |
---|---|---|
ClassDefinition |
PowerObject |
An object of type PowerObject containing information about the class definition of the object or control. |
RibbonApplicationMenu function |
Datatype returned |
Description |
---|---|---|
Long |
Adds a menu separator to the master menu of the application menu. A menu separator is a horizontal line used to visually distinguish between groups of menu items. |
|
String |
Returns the name assigned to the control. |
|
Integer |
Removes all recent menu items from the application menu. |
|
Long |
Removes a master menu item from the application menu. |
|
Integer |
Removes a recent menu item from the application menu. |
|
Integer |
Creates a reference to a context-specific instance of the specified service. |
|
Integer |
Gets the master menu item of the application menu. |
|
Long |
Determines the total number of the master menu items in the application menu. |
|
PowerObject |
Returns a reference to the name of the parent object. |
|
Integer |
Gets the recent menu item of the application menu. |
|
Long |
Determines the total number of the recent menu items in the application menu. |
|
Integer |
Gets the title of the recent menu list in the application menu. The title is displayed on top of the recent menu list. |
|
Long |
Inserts a master menu item at the specified position in the application menu. |
|
Long |
Inserts a master menu item as the first item in the application menu. |
|
Long |
Inserts a master menu item as the last item in the application menu. |
|
Long |
Inserts a recent menu item at the specified position in the application menu. |
|
Long |
Inserts a recent menu item as the first item in the application menu. |
|
Long |
Inserts a recent menu item as the last item in the application menu. |
|
Boolean |
Adds the specified event to the end of the event queue for the specified object |
|
Integer |
Sets a master menu item for the application menu in the RibbonBar control. |
|
Integer |
Sets a recent menu item for the application menu in the RibbonBar control. |
|
Integer |
Sets the title for the recent menu list in the application menu. The title will be displayed on top of the recent menu list. |
|
Integer |
Triggers a specified event in the control and executes the script for the event. |
|
Object |
Returns the type of the control. |