Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.jgoodies.looks.common
Class ShadowPopupFactory

    java.lang.Object
      javax.swing.PopupFactory
          com.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`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

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