WD98: How to Add a Drop-down Menu to the Main Menu Bar

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements. The following sample Microsoft Visual Basic for Applications macro (Sub procedure) adds a custom menu item (New Menu) to the main menu bar (Menu Bar), and then adds a submenu drop-down (Sub Menu) to the New Menu item.

NOTE: The default behavior is to show all menu items when no documents are open.

   Sub AddMenuItem()

      Dim oMainMenuBar As Object
      Dim oNewMenu As Object
      Dim oSubMenu As Object

      ' Save changes to menu bars in the Normal (default) Template.
      CustomizationContext = Application.NormalTemplate

      ' Specify the CommandBar to add to. In this example, the New Menu
      ' item is added to the Word for Windows default menu bar.
      Set oMainMenuBar = CommandBars.Item("Menu Bar")

      ' Create New Menu object and add it to the built-in menu bar.
      Set oNewMenu = oMainMenuBar.Controls.Add(Type:=msoControlPopup)
      oNewMenu.Caption = "New Menu Item"

      ' Create a submenu item for the New Menu menu item.
      Set oSubMenu = oNewMenu.Controls.Add(Type:=msoBarTypeMenuBar)

      With oSubMenu

         ' Give the submenu item a reference name and display text.
         .Caption = "Sub Menu"

         ' Specify macro to run when user clicks the submenu item.
         .OnAction = "NewMenuMacro"

      End With

   End Sub
				

The following sample macro runs when the user clicks the submenu item Sub Menu.

   Sub NewMenuMacro()

      Dim myMenuItem as Object
      Set myMenuItem = CommandBars("Menu Bar").Controls("New Menu Item")
      MsgBox myMenuItem.Caption

   End Sub