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

Last reviewed: February 16, 1998
Article ID: Q171130
The information in this article applies to:
  • Microsoft Word 97 for Windows

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 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 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/default.asp

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: vba vbe vb
Keywords : kbcode kbprg kbmacroexample word8 word97
Version : WINDOWS:97
Platform : WINDOWS
Issue type : kbhowto


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: February 16, 1998
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.