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

Last reviewed: March 3, 1998
Article ID: Q181395
The information in this article applies to:
  • Microsoft Word 98 Macintosh Edition

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 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

REFERENCES

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

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

   ARTICLE ID: Q181396
   TITLE     : WD98: Sample Macro to Remove a Submenu from a Menu

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

For more information about getting help with Visual Basic for Applications, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q163435
   TITLE     : VBA: Programming Resources for Visual Basic for
               Applications


Additional query words: vba vbe vb
Keywords : kbdta kbdtacode OffVBA macword98
Version : MACINTOSH:98
Platform : MACINTOSH
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: March 3, 1998
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.