Class ArrowKeyNavigationSupport

java.lang.Object
com.jidesoft.swing.ArrowKeyNavigationSupport

public class ArrowKeyNavigationSupport extends Object
This is a util class to support the four arrow keys navigation in any container. To use it, you can call
 new ArrowKeyNavigationSupport().install(container);
 
The container could be any container. A typical use case is the button panel. By default we used it in ButtonPanel class to enable left/right/up/down key.

By default, all components will be navigable in the container but you can further define what components are navigable by using the constructor

 new ArrowKeyNavigationSupport(Class[] componentTypes)
 
where componentTypes is the list of the classes of the components that you would like to be navigable. For example,
 new ArrowKeyNavigationSupport(new Class[]{ AbstractButton.class }).install(container);
 
to only allow any buttons (JButton, JideButton, JCheckBox, JRadioButton) etc.

You can also allow certain keys to be used. For example.

 new ArrowKeyNavigationSupport(new int[]{ KeyEvent.VK_LEFT, KeyEvent.VK_RIGHT}).install(container);
 
if only left and right keys are making sense to navigate in your container.
  • Field Details

    • CLIENT_PROPERTY_ARROWKEY_NAVIGATION_SUPPORT

      public static final String CLIENT_PROPERTY_ARROWKEY_NAVIGATION_SUPPORT
      See Also:
  • Constructor Details

    • ArrowKeyNavigationSupport

      public ArrowKeyNavigationSupport()
    • ArrowKeyNavigationSupport

      public ArrowKeyNavigationSupport(Class[] componentTypes)
    • ArrowKeyNavigationSupport

      public ArrowKeyNavigationSupport(int[] keyCodes)
    • ArrowKeyNavigationSupport

      public ArrowKeyNavigationSupport(Class[] componentTypes, int[] keyCode)
  • Method Details

    • install

      public void install(JComponent container)
      Installs the actions for arrow keys to allow user to navigate components using arrow keys.
      Parameters:
      container - the container such as ButtonPanel, JPanel etc.
    • uninstall

      public void uninstall(JComponent container)
      Uninstalls the actions for arrow keys.
      Parameters:
      container - the container such as ButtonPanel, JPanel etc.