MenuSets Property [Visio 2003 SDK Documentation]
Returns the MenuSets collection of a UIObject object.
objRet = object**.MenuSets**
objRet The MenuSets collection of a UIObject object.
object Required. An expression that returns the UIObject object that owns the collection.
Version added
4.0
Remarks
If a UIObject object represents menus and accelerators (for example, if the object was retrieved using the BuiltInMenus property of an Application or Document object), its MenuSets collection represents all of the menus for that UIObject object.
Use the ItemAtID property of a MenuSets object to retrieve menus for a particular window context such as the drawing window. If a context does not include menus, it has no MenuSets collection.
Example
This Microsoft Visual Basic for Applications (VBA) macro shows how to use the MenuSets property to get the MenuSets collection of a UIObject object. It adds a menu and menu item to the drawing window menu set and sets the menu and menu item's Caption properties.
To restore the built-in menus in Microsoft Office Visio after you run this macro, call the ThisDocument.ClearCustomMenus method.
Public Sub MenuSets_Example()
Dim vsoUIObject As Visio.UIObject
Dim vsoMenuSets As Visio.MenuSets
Dim vsoMenuSet As Visio.MenuSet
Dim vsoMenus As Visio.Menus
Dim vsoMenu As Visio.Menu
Dim vsoMenuItems As Visio.MenuItems
Dim vsoMenuItem As Visio.MenuItem
'Get a UIObject object that represents Microsoft Office Visio built-in menus.
Set vsoUIObject = Visio.Application.BuiltInMenus
'Get the MenuSet s collection.
Set vsoMenuSets = vsoUIObject.MenuSets
'Get the drawing window menu set.
Set vsoMenuSet = vsoMenuSets.ItemAtId(visUIObjSetDrawing)
'Get the Menus collection.
Set vsoMenus = vsoMenuSet.Menus
'Add a new menu before the Window menu.
Set vsoMenu = vsoMenus.AddAt(7)
vsoMenu.Caption = "MyNewMenu"
'Get the MenuItems collection.
Set vsoMenuItems = vsoMenu.MenuItems
'Add a menu item to the new menu.
Set vsoMenuItem = vsoMenuItems.Add
'Set the Caption property for the new menu item.
vsoMenuItem.Caption = "&MyNewMenuItem"
'Tell Visio to use the new UI when the document is active.
ThisDocument.SetCustomMenus vsoUIObject
End Sub
Applies to | UIObject object
See Also | BuiltInMenus property | ItemAtID property | MenuSets collection