ucar.unidata.util

Class MenuUtil

java.lang.Object

ucar.unidata.util.MenuUtil

Direct Known Subclasses:

LayoutUtil

public class MenuUtil
extends java.lang.Object

This is a vast catchall class to old various utilities for doing GUI things.

Author:

IDV development team

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	MENU_SEPARATOR Separator flag

Constructor Summary

Constructors

Constructor and Description
MenuUtil()

Method Summary

Modifier and Type	Method and Description
static java.lang.reflect.Method	findMethod(java.lang.Class c, java.lang.String methodName, java.lang.Class[] paramTypes) Find all methods with the given name.
static javax.swing.JCheckBoxMenuItem	makeCheckboxMenuItem(java.lang.String label, java.lang.Object object, java.lang.String property, boolean value, java.lang.Object arg) Make a checkbox menu item.
static javax.swing.JCheckBoxMenuItem	makeCheckboxMenuItem(java.lang.String label, java.lang.Object object, java.lang.String property, java.lang.Object arg) Make a checkbox menu item.
static javax.swing.JMenu	makeMenu(javax.swing.JMenu menu, java.util.List menuItems) Create a JMenu and add the menus contained with the menus list If no menus then return null.
static javax.swing.JMenu	makeMenu(java.lang.String name, java.util.List menuItems) Create a JMenu and add the menus contained with the menus list If no menus then return null.
static javax.swing.JMenuItem	makeMenuItem(java.lang.String label, java.lang.Object object, java.lang.String methodName) Make a jmenuItem.
static javax.swing.JMenuItem	makeMenuItem(java.lang.String label, java.lang.Object object, java.lang.String methodName, java.lang.Object arg) Make a jmenuItem.
static javax.swing.JMenuItem	makeMenuItem(java.lang.String label, java.lang.Object object, java.lang.String methodName, java.lang.Object arg, boolean inThread) Make a jmenuItem.
static java.util.List	makeMenuItems(java.lang.Object object, java.lang.Object[][] items) Utility to make a list of menu items.
static javax.swing.JPopupMenu	makePopupMenu(javax.swing.JPopupMenu menu, java.util.List menuItems) Create a JPopupMenu and add the menus contained with the menus list If no menus then return null.
static javax.swing.JPopupMenu	makePopupMenu(java.util.List menuItems) Create a JPopupMenu and add the menus contained with the menus list If no menus then return null.
static void	showPopupMenu(java.util.List menuItems, java.awt.Component comp) Create a popup menu and show it near the given component
static boolean	typesMatch(java.lang.Class[] formals, java.lang.Class[] actuals) Returns true if the Classes defined in the actual parameter are equal or a sub-class of the corresponding classes defined in the formal argument.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MENU_SEPARATOR

public static final java.lang.String MENU_SEPARATOR

Separator flag

See Also:

Constant Field Values

Constructor Detail

MenuUtil

public MenuUtil()

Method Detail

typesMatch

public static boolean typesMatch(java.lang.Class[] formals,
                                 java.lang.Class[] actuals)

Returns true if the Classes defined in the actual parameter are equal or a sub-class of the corresponding classes defined in the formal argument.

Parameters:

formals - formal classes (types)

actuals - actual classes

Returns:

true if they match

findMethod

public static java.lang.reflect.Method findMethod(java.lang.Class c,
                                                  java.lang.String methodName,
                                                  java.lang.Class[] paramTypes)

Find all methods with the given name. Of these methods find one whose parameter types are assignable from the given parameter types.

Parameters:

c - class to check

methodName - name of method

paramTypes - parameter types

Returns:

class method or null if one doesn't exist

makeMenuItem

public static javax.swing.JMenuItem makeMenuItem(java.lang.String label,
                                                 java.lang.Object object,
                                                 java.lang.String methodName,
                                                 java.lang.Object arg)

Make a jmenuItem. Call methodName on object when menuItem pressed. Pass in given arg if non-null.

Parameters:

label - Label

object - Object to call

methodName - Method name to call

arg - Pass this to method name if non-null.

Returns:

The menuItem

makeMenuItem

public static javax.swing.JMenuItem makeMenuItem(java.lang.String label,
                                                 java.lang.Object object,
                                                 java.lang.String methodName)

Make a jmenuItem. Call methodName on object when menuItem pressed.

Parameters:

label - Label

object - Object to call

methodName - Method name to call

Returns:

The menuItem

makeMenuItem

public static javax.swing.JMenuItem makeMenuItem(java.lang.String label,
                                                 java.lang.Object object,
                                                 java.lang.String methodName,
                                                 java.lang.Object arg,
                                                 boolean inThread)

Make a jmenuItem. Call methodName on object when menuItem pressed. Pass in given arg if non-null.

Parameters:

label - Label

object - Object to call

methodName - Method name to call

arg - Pass this to method name if non-null.

inThread - If true then call the method in a thread

Returns:

The menuItem

makeCheckboxMenuItem

public static javax.swing.JCheckBoxMenuItem makeCheckboxMenuItem(java.lang.String label,
                                                                 java.lang.Object object,
                                                                 java.lang.String property,
                                                                 java.lang.Object arg)

Make a checkbox menu item. Automatically call the set'property' method on the object

Parameters:

label - Label

object - Object to call

property - Name of property to get/set value

arg - Optional arg to pass to method

Returns:

The checkbox

makeCheckboxMenuItem

public static javax.swing.JCheckBoxMenuItem makeCheckboxMenuItem(java.lang.String label,
                                                                 java.lang.Object object,
                                                                 java.lang.String property,
                                                                 boolean value,
                                                                 java.lang.Object arg)

Make a checkbox menu item. Automatically call the set'property' method on the object

Parameters:

label - Label

object - Object to call

property - Name of property to get/set value

value - The value

arg - Optional arg to pass to method

Returns:

The checkbox

makeMenu

public static javax.swing.JMenu makeMenu(java.lang.String name,
                                         java.util.List menuItems)

Create a JMenu and add the menus contained with the menus list If no menus then return null.

Parameters:

name - The menu name

menuItems - List of either, JMenu, JMenuItem or MENU_SEPARATOR

Returns:

The new menu

makeMenu

public static javax.swing.JMenu makeMenu(javax.swing.JMenu menu,
                                         java.util.List menuItems)

Create a JMenu and add the menus contained with the menus list If no menus then return null.

Parameters:

menu - The menu to add to

menuItems - List of either, JMenu, JMenuItem or MENU_SEPARATOR

Returns:

The given menu

makeMenuItems

public static java.util.List makeMenuItems(java.lang.Object object,
                                           java.lang.Object[][] items)

Utility to make a list of menu items.

Parameters:

object - The object to call the method on

items - An array. Each sub array has at least two elements:

 {Menu name, method name}
 

If it has 3 elements then the 3rd element is an argument that is also passed to the method. If it has 4 elements then the 4th element is a tooltip. If there are 4 elements and the 3rd element is null then we don't try to find a method that tags an extra argument.

Returns:

List of menu items

showPopupMenu

public static void showPopupMenu(java.util.List menuItems,
                                 java.awt.Component comp)

Create a popup menu and show it near the given component

Parameters:

menuItems - List of menu items

comp - Component to show the menu at

makePopupMenu

public static javax.swing.JPopupMenu makePopupMenu(javax.swing.JPopupMenu menu,
                                                   java.util.List menuItems)

Create a JPopupMenu and add the menus contained with the menus list If no menus then return null.

Parameters:

menu - The menu

menuItems - List of either, JMenu, JMenuItem or MENU_SEPARATOR

Returns:

The given menu

makePopupMenu

public static javax.swing.JPopupMenu makePopupMenu(java.util.List menuItems)

Create a JPopupMenu and add the menus contained with the menus list If no menus then return null.

Parameters:

menuItems - List of either, JMenu, JMenuItem or MENU_SEPARATOR

Returns:

The new popup menu