Adobe 65009333 Scripting Guide - Page 67
Menus and events, Object, Event, Description
UPC - 883919155852
View all Adobe 65009333 manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 67 highlights
Menus Menus and events 67 var myMainMenu = app.menus.item("Main"); var myTypeMenu = myMainMenu.menuElements.item("Type"); var myFontMenu = myTypeMenu.menuElements.item("Font"); var myKozukaMenu = myFontMenu.submenus.item("Kozuka Mincho Pro "); var mySpecialFontMenu = myMainMenu.submenus.add("Kozuka Mincho Pro"); for(myCounter = 0;myCounter < myKozukaMenu.menuItems.length; myCounter++){ var myAssociatedMenuAction = myKozukaMenu.menuItems.item(myCounter).associatedMenuAction; mySpecialFontMenu.menuItems.add(myAssociatedMenuAction); } To remove the custom menu added by the above script, run the RemoveSpecialFontMenu script. var myMainMenu = app.menus.item("Main"); var mySpecialFontMenu = myMainMenu.submenus.item("Kozuka Mincho Pro"); mySpecialFontMenu.remove(); Menus and events Menus and submenus generate events as they are chosen in the user interface, and menuActions and scriptMenuActions generate events as they are used. Scripts can install eventListeners to respond to these events. The following table shows the events for the different menu scripting components: Object menu menuAction scriptMenuAction submenu Event beforeDisplay afterInvoke beforeInvoke afterInvoke beforeInvoke beforeDisplay onInvoke beforeDisplay Description Runs the attached script before the contents of the menu is shown. Runs the attached script when the associated menuItem is selected, but after the onInvoke event. Runs the attached script when the associated menuItem is selected, but before the onInvoke event. Runs the attached script when the associated menuItem is selected, but after the onInvoke event. Runs the attached script when the associated menuItem is selected, but before the onInvoke event. Runs the attached script before an internal request for the enabled/checked status of the scriptMenuActionscriptMenuAction. Runs the attached script when the scriptMenuAction is invoked. Runs the attached script before the contents of the submenu are shown. For more about events and eventListeners, see Chapter 7, "Events." To change the items displayed in a menu, add an eventListener for the beforeDisplay event. When the menu is selected, the eventListener can then run a script that enables or disables menu items, changes the wording of menu item, or performs other tasks related to the menu. This mechanism is used internally to change the menu listing of available fonts, recent documents, or open windows.