edu.wisc.ssec.mcidasv.ui

Class MenuScroller

java.lang.Object

edu.wisc.ssec.mcidasv.ui.MenuScroller

public class MenuScroller
extends java.lang.Object

A class that provides scrolling capabilities to a long menu dropdown or popup menu. A number of items can optionally be frozen at the top of the menu.

Implementation note: The default scrolling interval is 150 milliseconds.

Since:

4593 MenuScroller.java 1.5.0 04/02/12 License: use / modify without restrictions (see https://tips4java.wordpress.com/about/) Heavily modified for JOSM needs => drop unused features and replace static scrollcount approach by dynamic behaviour

Author:

Darryl, https://tips4java.wordpress.com/2009/02/01/menu-scroller/

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	MenuScroller.MenuIcon
private class	MenuScroller.MenuScrollItem
private class	MenuScroller.MenuScrollListener
private class	MenuScroller.MenuScrollTimer
private class	MenuScroller.MouseScrollListener
private class	MenuScroller.TimerListener

Field Summary

Fields

Modifier and Type	Field and Description
private static int	ARROW_ICON_HEIGHT
private MenuScroller.MenuScrollItem	downItem
private int	firstIndex
private int	interval
private javax.swing.JPopupMenu	menu
private java.awt.Component[]	menuItems
private MenuScroller.MenuScrollListener	menuListener
private java.awt.event.MouseWheelListener	mouseWheelListener
private javax.swing.JComponent	parent
private int	topFixedCount
private MenuScroller.MenuScrollItem	upItem

Constructor Summary

Constructors

Constructor and Description
MenuScroller(javax.swing.JComponent parentComp, javax.swing.JMenu menu)
MenuScroller(javax.swing.JComponent parentComp, javax.swing.JMenu menu, int interval)
MenuScroller(javax.swing.JComponent parentComp, javax.swing.JMenu menu, int interval, int topFixedCount)
MenuScroller(javax.swing.JMenu menu) Constructs a MenuScroller that scrolls a menu with the default scrolling interval.
MenuScroller(javax.swing.JMenu menu, int interval) Constructs a MenuScroller that scrolls a menu with the specified scrolling interval.
MenuScroller(javax.swing.JMenu menu, int interval, int topFixedCount) Constructs a MenuScroller that scrolls a menu with the specified scrolling interval, and the specified numbers of items fixed at the top of the menu.
MenuScroller(javax.swing.JPopupMenu menu) Constructs a MenuScroller that scrolls a popup menu with the default scrolling interval.
MenuScroller(javax.swing.JPopupMenu menu, int interval) Constructs a MenuScroller that scrolls a popup menu with the specified scrolling interval.
MenuScroller(javax.swing.JPopupMenu menu, int interval, int topFixedCount) Constructs a MenuScroller that scrolls a popup menu with the specified scrolling interval, and the specified numbers of items fixed at the top of the popup menu.

Method Summary

Modifier and Type	Method and Description
private int	computeScrollCount(int startIndex)
void	dispose() Removes this MenuScroller from the associated menu and restores the default behavior of the menu.
protected void	finalize() Ensures that the dispose method of this MenuScroller is called when there are no more refrences to it.
int	getInterval() Returns the scroll interval in milliseconds
static java.awt.Dimension	getMaxDimensionOnScreen(javax.swing.JComponent parent, javax.swing.JComponent component) Computes the maximum dimension for a component to fit in screen displaying component.
int	getTopFixedCount() Returns the number of items fixed at the top of the menu or popup menu.
private void	refreshMenu()
void	resetMenu()
void	setInterval(int interval) Sets the scroll interval in milliseconds
void	setParent(javax.swing.JComponent parent)
static MenuScroller	setScrollerFor(javax.swing.JMenu menu) Registers a menu to be scrolled with the default scrolling interval.
static MenuScroller	setScrollerFor(javax.swing.JMenu menu, int interval) Registers a menu to be scrolled, with the specified scrolling interval.
static MenuScroller	setScrollerFor(javax.swing.JMenu menu, int interval, int topFixedCount) Registers a menu to be scrolled, with the specified scrolling interval, and the specified numbers of items fixed at the top of the menu.
static MenuScroller	setScrollerFor(javax.swing.JPopupMenu menu) Registers a popup menu to be scrolled with the default scrolling interval.
static MenuScroller	setScrollerFor(javax.swing.JPopupMenu menu, int interval) Registers a popup menu to be scrolled, with the specified scrolling interval.
static MenuScroller	setScrollerFor(javax.swing.JPopupMenu menu, int interval, int topFixedCount) Registers a popup menu to be scrolled, with the specified scrolling interval, and the specified numbers of items fixed at the top of the popup menu.
void	setTopFixedCount(int topFixedCount) Sets the number of items to fix at the top of the menu or popup menu.

Methods inherited from class java.lang.Object

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

Field Detail

parent

private javax.swing.JComponent parent

menu

private javax.swing.JPopupMenu menu

menuItems

private java.awt.Component[] menuItems

upItem

private MenuScroller.MenuScrollItem upItem

downItem

private MenuScroller.MenuScrollItem downItem

menuListener

private final MenuScroller.MenuScrollListener menuListener

mouseWheelListener

private final java.awt.event.MouseWheelListener mouseWheelListener

interval

private int interval

topFixedCount

private int topFixedCount

firstIndex

private int firstIndex

ARROW_ICON_HEIGHT

private static final int ARROW_ICON_HEIGHT

See Also:

Constant Field Values

Constructor Detail

MenuScroller

public MenuScroller(javax.swing.JMenu menu)

Constructs a MenuScroller that scrolls a menu with the default scrolling interval.

Parameters:

menu - the menu

Throws:

java.lang.IllegalArgumentException - if scrollCount is 0 or negative

MenuScroller

public MenuScroller(javax.swing.JComponent parentComp,
                    javax.swing.JMenu menu)

MenuScroller

public MenuScroller(javax.swing.JPopupMenu menu)

Constructs a MenuScroller that scrolls a popup menu with the default scrolling interval.

Parameters:

menu - the popup menu

Throws:

java.lang.IllegalArgumentException - if scrollCount is 0 or negative

MenuScroller

public MenuScroller(javax.swing.JMenu menu,
                    int interval)

Constructs a MenuScroller that scrolls a menu with the specified scrolling interval.

Parameters:

menu - the menu

interval - the scroll interval, in milliseconds

Throws:

java.lang.IllegalArgumentException - if scrollCount or interval is 0 or negative

MenuScroller

public MenuScroller(javax.swing.JPopupMenu menu,
                    int interval)

Constructs a MenuScroller that scrolls a popup menu with the specified scrolling interval.

Parameters:

menu - the popup menu

interval - the scroll interval, in milliseconds

Throws:

java.lang.IllegalArgumentException - if scrollCount or interval is 0 or negative

MenuScroller

public MenuScroller(javax.swing.JComponent parentComp,
                    javax.swing.JMenu menu,
                    int interval)

MenuScroller

public MenuScroller(javax.swing.JMenu menu,
                    int interval,
                    int topFixedCount)

Constructs a MenuScroller that scrolls a menu with the specified scrolling interval, and the specified numbers of items fixed at the top of the menu.

Parameters:

menu - the menu

interval - the scroll interval, in milliseconds

topFixedCount - the number of items to fix at the top. May be 0

Throws:

java.lang.IllegalArgumentException - if scrollCount or interval is 0 or negative or if topFixedCount is negative

MenuScroller

public MenuScroller(javax.swing.JComponent parentComp,
                    javax.swing.JMenu menu,
                    int interval,
                    int topFixedCount)

MenuScroller

public MenuScroller(javax.swing.JPopupMenu menu,
                    int interval,
                    int topFixedCount)

Constructs a MenuScroller that scrolls a popup menu with the specified scrolling interval, and the specified numbers of items fixed at the top of the popup menu.

Parameters:

menu - the popup menu

interval - the scroll interval, in milliseconds

topFixedCount - the number of items to fix at the top. May be 0

Throws:

java.lang.IllegalArgumentException - if scrollCount or interval is 0 or negative or if topFixedCount is negative

Method Detail

getMaxDimensionOnScreen

public static java.awt.Dimension getMaxDimensionOnScreen(javax.swing.JComponent parent,
                                                         javax.swing.JComponent component)

Computes the maximum dimension for a component to fit in screen displaying component.

Parameters:

component - The component to get current screen info from. Must not be null

Returns:

Maximum dimension for a component to fit in current screen.

Throws:

java.lang.NullPointerException - if component is null.

computeScrollCount

private int computeScrollCount(int startIndex)

setScrollerFor

public static MenuScroller setScrollerFor(javax.swing.JMenu menu)

Registers a menu to be scrolled with the default scrolling interval.

Parameters:

menu - Menu to

Returns:

the MenuScroller

setScrollerFor

public static MenuScroller setScrollerFor(javax.swing.JPopupMenu menu)

Registers a popup menu to be scrolled with the default scrolling interval.

Parameters:

menu - the popup menu

Returns:

the MenuScroller

setScrollerFor

public static MenuScroller setScrollerFor(javax.swing.JMenu menu,
                                          int interval)

Registers a menu to be scrolled, with the specified scrolling interval.

Parameters:

menu - the menu

interval - the scroll interval, in milliseconds

Returns:

the MenuScroller

Throws:

java.lang.IllegalArgumentException - if scrollCount or interval is 0 or negative

setScrollerFor

public static MenuScroller setScrollerFor(javax.swing.JPopupMenu menu,
                                          int interval)

Registers a popup menu to be scrolled, with the specified scrolling interval.

Parameters:

menu - the popup menu

interval - the scroll interval, in milliseconds

Returns:

the MenuScroller

Throws:

java.lang.IllegalArgumentException - if scrollCount or interval is 0 or negative

setScrollerFor

public static MenuScroller setScrollerFor(javax.swing.JMenu menu,
                                          int interval,
                                          int topFixedCount)

Registers a menu to be scrolled, with the specified scrolling interval, and the specified numbers of items fixed at the top of the menu.

Parameters:

menu - the menu

interval - the scroll interval, in milliseconds

topFixedCount - the number of items to fix at the top. May be 0.

Returns:

the MenuScroller

Throws:

java.lang.IllegalArgumentException - if scrollCount or interval is 0 or negative or if topFixedCount is negative

setScrollerFor

public static MenuScroller setScrollerFor(javax.swing.JPopupMenu menu,
                                          int interval,
                                          int topFixedCount)

Registers a popup menu to be scrolled, with the specified scrolling interval, and the specified numbers of items fixed at the top of the popup menu.

Parameters:

menu - the popup menu

interval - the scroll interval, in milliseconds

topFixedCount - the number of items to fix at the top. May be 0

Returns:

the MenuScroller

Throws:

java.lang.IllegalArgumentException - if scrollCount or interval is 0 or negative or if topFixedCount is negative

getInterval

public int getInterval()

Returns the scroll interval in milliseconds

Returns:

the scroll interval in milliseconds

setInterval

public void setInterval(int interval)

Sets the scroll interval in milliseconds

Parameters:

interval - the scroll interval in milliseconds

Throws:

java.lang.IllegalArgumentException - if interval is 0 or negative

getTopFixedCount

public int getTopFixedCount()

Returns the number of items fixed at the top of the menu or popup menu.

Returns:

the number of items

setTopFixedCount

public void setTopFixedCount(int topFixedCount)

Sets the number of items to fix at the top of the menu or popup menu.

Parameters:

topFixedCount - the number of items

dispose

public void dispose()

Removes this MenuScroller from the associated menu and restores the default behavior of the menu.

resetMenu

public void resetMenu()

finalize

protected void finalize()
                 throws java.lang.Throwable

Ensures that the dispose method of this MenuScroller is called when there are no more refrences to it.

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable - if an error occurs.

See Also:

dispose()

setParent

public void setParent(javax.swing.JComponent parent)

refreshMenu

private void refreshMenu()