- java.lang.Object
-
- ij.Menus
-
public class Menus extends java.lang.ObjectThis class installs and updates ImageJ's menus. Note that menu labels, even in submenus, must be unique. This is because ImageJ uses a single hash table for all menu labels. If you look closely, you will see that File->Import->Text Image... and File->Save As->Text Image... do not use the same label. One of the labels has an extra space.- See Also:
ImageJ
-
-
Field Summary
Fields Modifier and Type Field Description static charABOUT_MENUstatic intCOMMAND_IN_USEstatic intCOMMAND_NOT_FOUNDstatic charFILTERS_MENUstatic charIMPORT_MENUstatic intINVALID_SHORTCUTstatic intMAX_OPEN_RECENT_ITEMSstatic intNORMAL_RETURNstatic intNOT_INSTALLEDstatic charPLUGINS_MENUstatic charSAVE_AS_MENUstatic intsetMenuBarCountstatic intSHORTCUT_IN_USEstatic charSHORTCUTS_MENUstatic charTOOLS_MENUstatic charUTILITIES_MENUstatic intWINDOW_MENU_ITEMS
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static voidadd(java.lang.String menuPath, java.lang.String plugin)Adds a command to the ImageJ menu bar.static voidaddOpenRecentItem(java.lang.String path)Adds a file path to the beginning of the File/Open Recent submenu.static booleancommandInUse(java.lang.String command)static intconvertShortcutToCode(java.lang.String shortcut)static java.awt.FontgetCachedFont()static java.util.HashtablegetCommands()Returns the hashtable that associates commands with plugins.static java.awt.MenugetExamplesMenu(java.awt.event.ActionListener listener)static java.awt.FontgetFont()static java.awt.FontgetFont(boolean checkSize)static intgetFontSize()Returns the size (in points) used for the fonts in ImageJ menus.static java.awt.MenugetImageJMenu(java.lang.String menuPath)Returns the specified ImageJ menu (e.g., "File>New") or null if it is not found.static java.lang.StringgetJarFileForMenuEntry(java.lang.String menuEntry)intgetMacroCount()static java.util.HashtablegetMacroShortcuts()Returns the hashtable that associates keyboard shortcuts with macros.static java.awt.MenugetMacrosMenu()static java.lang.StringgetMacrosPath()Returns the path to the macros directory or null if the macros directory was not found.static java.awt.MenuBargetMenuBar()static java.awt.MenugetOpenRecentMenu()intgetPluginCount()static java.lang.String[]getPlugins()Returns a list of the plugins in the plugins menu.static java.lang.StringgetPlugInsPath()Returns the path to the user plugins directory or null if the plugins directory was not found.static java.awt.PopupMenugetPopupMenu()static java.awt.MenugetSaveAsMenu()static java.util.HashtablegetShortcuts()Returns the hashtable that associates shortcuts with commands.static intinstallPlugin(java.lang.String plugin, char menuCode, java.lang.String command, java.lang.String shortcut, ImageJ ij)Adds a plugin based command to the end of a specified menu.voidinstallUserPlugin(java.lang.String className, boolean force)static voidsavePreferences(java.util.Properties prefs)Called once when ImageJ quits.static voidsetFontSize(int size)Set the size (in points) used for the fonts in ImageJ menus.static booleanshortcutInUse(java.lang.String shortcut)Returns 'true' if this keyboard shortcut is in use.static intuninstallPlugin(java.lang.String command)Deletes a command installed by Plugins/Shortcuts/Add Shortcut.static voidupdateFont()static voidupdateImageJMenus()static voidupdateMenus()Updates the Image/Type and Window menus.static voidupdateWindowMenuItem(ImagePlus imp, java.lang.String oldLabel, java.lang.String newLabel)Changes the name of an item in the Window menu.static voidupdateWindowMenuItem(java.lang.String oldLabel, java.lang.String newLabel)Changes the name of an item in the Window menu.
-
-
-
Field Detail
-
PLUGINS_MENU
public static final char PLUGINS_MENU
- See Also:
- Constant Field Values
-
IMPORT_MENU
public static final char IMPORT_MENU
- See Also:
- Constant Field Values
-
SAVE_AS_MENU
public static final char SAVE_AS_MENU
- See Also:
- Constant Field Values
-
SHORTCUTS_MENU
public static final char SHORTCUTS_MENU
- See Also:
- Constant Field Values
-
ABOUT_MENU
public static final char ABOUT_MENU
- See Also:
- Constant Field Values
-
FILTERS_MENU
public static final char FILTERS_MENU
- See Also:
- Constant Field Values
-
TOOLS_MENU
public static final char TOOLS_MENU
- See Also:
- Constant Field Values
-
UTILITIES_MENU
public static final char UTILITIES_MENU
- See Also:
- Constant Field Values
-
WINDOW_MENU_ITEMS
public static final int WINDOW_MENU_ITEMS
- See Also:
- Constant Field Values
-
NORMAL_RETURN
public static final int NORMAL_RETURN
- See Also:
- Constant Field Values
-
COMMAND_IN_USE
public static final int COMMAND_IN_USE
- See Also:
- Constant Field Values
-
INVALID_SHORTCUT
public static final int INVALID_SHORTCUT
- See Also:
- Constant Field Values
-
SHORTCUT_IN_USE
public static final int SHORTCUT_IN_USE
- See Also:
- Constant Field Values
-
NOT_INSTALLED
public static final int NOT_INSTALLED
- See Also:
- Constant Field Values
-
COMMAND_NOT_FOUND
public static final int COMMAND_NOT_FOUND
- See Also:
- Constant Field Values
-
MAX_OPEN_RECENT_ITEMS
public static final int MAX_OPEN_RECENT_ITEMS
- See Also:
- Constant Field Values
-
setMenuBarCount
public static int setMenuBarCount
-
-
Method Detail
-
getExamplesMenu
public static java.awt.Menu getExamplesMenu(java.awt.event.ActionListener listener)
-
getJarFileForMenuEntry
public static java.lang.String getJarFileForMenuEntry(java.lang.String menuEntry)
-
getImageJMenu
public static java.awt.Menu getImageJMenu(java.lang.String menuPath)
Returns the specified ImageJ menu (e.g., "File>New") or null if it is not found.
-
getPlugins
public static java.lang.String[] getPlugins()
Returns a list of the plugins in the plugins menu.
-
installUserPlugin
public void installUserPlugin(java.lang.String className, boolean force)
-
getMenuBar
public static java.awt.MenuBar getMenuBar()
-
getMacrosMenu
public static java.awt.Menu getMacrosMenu()
-
getOpenRecentMenu
public static java.awt.Menu getOpenRecentMenu()
-
getMacroCount
public int getMacroCount()
-
getPluginCount
public int getPluginCount()
-
updateMenus
public static void updateMenus()
Updates the Image/Type and Window menus.
-
getPlugInsPath
public static java.lang.String getPlugInsPath()
Returns the path to the user plugins directory or null if the plugins directory was not found.
-
getMacrosPath
public static java.lang.String getMacrosPath()
Returns the path to the macros directory or null if the macros directory was not found.
-
getCommands
public static java.util.Hashtable getCommands()
Returns the hashtable that associates commands with plugins.
-
getShortcuts
public static java.util.Hashtable getShortcuts()
Returns the hashtable that associates shortcuts with commands. The keys in the hashtable are Integer keycodes, or keycode+200 for uppercase.
-
getMacroShortcuts
public static java.util.Hashtable getMacroShortcuts()
Returns the hashtable that associates keyboard shortcuts with macros. The keys in the hashtable are Integer keycodes, or keycode+200 for uppercase.
-
updateWindowMenuItem
public static void updateWindowMenuItem(java.lang.String oldLabel, java.lang.String newLabel)Changes the name of an item in the Window menu.
-
updateWindowMenuItem
public static void updateWindowMenuItem(ImagePlus imp, java.lang.String oldLabel, java.lang.String newLabel)
Changes the name of an item in the Window menu.
-
addOpenRecentItem
public static void addOpenRecentItem(java.lang.String path)
Adds a file path to the beginning of the File/Open Recent submenu.
-
getPopupMenu
public static java.awt.PopupMenu getPopupMenu()
-
getSaveAsMenu
public static java.awt.Menu getSaveAsMenu()
-
installPlugin
public static int installPlugin(java.lang.String plugin, char menuCode, java.lang.String command, java.lang.String shortcut, ImageJ ij)Adds a plugin based command to the end of a specified menu.- Parameters:
plugin- the plugin (e.g. "Inverter_", "Inverter_("arg")")menuCode- PLUGINS_MENU, IMPORT_MENU, SAVE_AS_MENU or HOT_KEYScommand- the menu item label (set to "" to uninstall)shortcut- the keyboard shortcut (e.g. "y", "Y", "F1")ij- ImageJ (the action listener)- Returns:
- returns an error code(NORMAL_RETURN,COMMAND_IN_USE_ERROR, etc.)
-
uninstallPlugin
public static int uninstallPlugin(java.lang.String command)
Deletes a command installed by Plugins/Shortcuts/Add Shortcut.
-
commandInUse
public static boolean commandInUse(java.lang.String command)
-
convertShortcutToCode
public static int convertShortcutToCode(java.lang.String shortcut)
-
shortcutInUse
public static boolean shortcutInUse(java.lang.String shortcut)
Returns 'true' if this keyboard shortcut is in use.
-
setFontSize
public static void setFontSize(int size)
Set the size (in points) used for the fonts in ImageJ menus. Set the size to 0 to use the Java default size.
-
getFontSize
public static int getFontSize()
Returns the size (in points) used for the fonts in ImageJ menus. Returns 0 if the default font size is being used or if this is a Macintosh.
-
getFont
public static java.awt.Font getFont()
-
getFont
public static java.awt.Font getFont(boolean checkSize)
-
getCachedFont
public static java.awt.Font getCachedFont()
-
savePreferences
public static void savePreferences(java.util.Properties prefs)
Called once when ImageJ quits.
-
updateImageJMenus
public static void updateImageJMenus()
-
updateFont
public static void updateFont()
-
add
public static void add(java.lang.String menuPath, java.lang.String plugin)Adds a command to the ImageJ menu bar.
-
-