com.jgoodies.looks.common
Class ShadowPopupFactory

java.lang.Object
  extended byjavax.swing.PopupFactory
      extended bycom.jgoodies.looks.common.ShadowPopupFactory

public final class ShadowPopupFactory
extends PopupFactory

The JGoodies Looks implementation of PopupFactory. Adds a drop shadow border to all popups except ComboBox popups. It is installed by the JGoodies Plastic L&F, as well as by the JGoodies Windows L&F during the Look&Feel initialization, see PlasticLookAndFeel.initialize() and WindowsLookAndFeel.initialize().

This factory shall not be used on platforms that provide native drop shadows, such as the Mac OS X. Therefore the invocation of the install() method will have no effect on such platforms.

Note: To be used in a sandbox environment, this PopupFactory requires two AWT permissions: createRobot and readDisplayPixels. The reason for it is, that in the case of the heavy weight popups this PopupFactory uses a Robot to snapshot the screen background to simulate the drop shadow effect.

Version:
$Revision: 1.1 $
Author:
Andrej Golovnin, Karsten Lentzsch
See Also:
AWTPermission, Robot, Popup, LookAndFeel.initialize(), LookAndFeel.uninitialize()

Method Summary
 Popup getPopup(Component owner, Component contents, int x, int y)
          
static void install()
          Installs the ShadowPopupFactory as the shared popup factory.
static void uninstall()
          Uninstalls the ShadowPopupFactory and restores the original popup factory as the new shared popup factory.
 
Methods inherited from class javax.swing.PopupFactory
getSharedInstance, setSharedInstance
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

install

public static void install()
Installs the ShadowPopupFactory as the shared popup factory. Also stores the previously set factory in the replacement, so that it can be restored in #uninstall.

See Also:
uninstall()

uninstall

public static void uninstall()
Uninstalls the ShadowPopupFactory and restores the original popup factory as the new shared popup factory.

See Also:
install()

getPopup

public Popup getPopup(Component owner,
                      Component contents,
                      int x,
                      int y)
               throws IllegalArgumentException

Throws:
IllegalArgumentException


Copyright © 2001-2005 JGoodies Karsten Lentzsch. All Rights Reserved.