Adobe acrobat 7.0.5 sdk User Manual

Page of 122
Modifying the User Interface
Modifying the Toolbar
6
60
Adobe keeps a registry of plug-in menu item names to help avoid conflicts between plug-
ins. For more information on registering and using plug-in prefixes, see the Acrobat SDK 
Plug-in Guide
.
Adding a New Menu
To create a new menu, use the 
AVMenuNew
 method from a plug-in. Add a new (or an 
existing) menu to a menu bar using the 
AVMenuBarAddMenu
 method.
You cannot create menus or add menus to menu bars using Acrobat JavaScript or IAC.
Modifying the Toolbar
You can use the Acrobat SDK to manipulate tool buttons and toolbars. For complete 
information on what functionality is available with each SDK technology, see the Acrobat 
and PDF Library API Reference
, the Acrobat JavaScript Scripting Reference, or the Acrobat 
Interapplication Communication Reference
.
Adding Items to an Existing Toolbar
You can add or remove buttons to the toolbar, although the size and resolution of the user’s 
monitor can limit the number of tool buttons that can be added. 
From a plug-in, use the methods of the 
AVToolBar
 and 
AVToolButton
 objects. From 
Acrobat JavaScript, use the 
app
 object’s 
addToolButton
 and 
removeToolButton
 
methods.
With IAC OLE automation, you can remove a menu item using the 
App.MenuItemRemove
 method. However, you cannot use IAC to add a menu item. 
Creating a New Toolbar
Plug-ins also can create new toolbars, called flyouts, that can be attached to buttons on the 
main toolbar. The selection tools, for example, are all on a flyout. As of Acrobat 4.0, it is no 
longer true that all tool buttons are located on the main toolbar; some may be located on a 
flyout.
You cannot create a flyout with Acrobat JavaScript or IAC.