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

ID: Q171130

The information in this article applies to:

SUMMARY

This article describes how to add a drop-down menu to the menu bar that appears when no documents are open.

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft support professionals 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 needs. If you have limited programming experience, you may want to contact the Microsoft fee-based consulting line at (800) 936-5200. For more information about the support options available from Microsoft, please see the following page on the World Wide Web:

   http://www.microsoft.com/support/supportnet/refguide/

The following sample Visual Basic for Applications macro 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

For more information about customizing command bars, while in the Visual Basic for Applications Editor click the Office Assistant, type "command bars" (without the quotation marks), click Search, and then click to view the "Using command bars" topic.

Or, please see the following article in the Microsoft Knowledge Base:

   ARTICLE ID: Q163160
   TITLE: WD97: Sample Macro to Remove a Submenu From a Menu

For additional information, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q173707
   TITLE     : OFF97: How to Run Sample Code from Knowledge Base Articles

Additional query words: wordcon vba vbe vb

Keywords          : kbcode kbprg kbmacroexample word8 word97 
Version           : WINDOWS:97
Platform          : WINDOWS
Issue type        : kbhowto

Last Reviewed: April 2, 1999