Package Summary Overview Summary

### class:PopupFactory [NONE]
-     public class PopupFactory
      extends Object
  `PopupFactory`, as the name implies, is used to obtain instances of `Popup`s. `Popup`s are used to display a `Component` above all other `Component`s in a particular containment hierarchy. The general contract is that once you have obtained a `Popup` from a `PopupFactory`, you must invoke `hide` on the `Popup`. The typical usage is:
         PopupFactory factory = PopupFactory.getSharedInstance();
         Popup popup = factory.getPopup(owner, contents, x, y);
         popup.show();
         ...
         popup.hide();
Since: 1.4 See Also: `Popup`

### constructor:PopupFactory() [NONE]
- #### PopupFactory
      public PopupFactory()

### method:setSharedInstance(javax.swing.PopupFactory) [NONE]
- #### setSharedInstance
      public static void setSharedInstance(PopupFactory factory)
Sets the `PopupFactory` that will be used to obtain `Popup`s. This will throw an `IllegalArgumentException` if `factory` is null. Parameters: `factory` - Shared PopupFactory Throws: `IllegalArgumentException` - if `factory` is null See Also: `getPopup(java.awt.Component, java.awt.Component, int, int)`

### method:getSharedInstance() [NONE]
- #### getSharedInstance
      public static PopupFactory getSharedInstance()
Returns the shared `PopupFactory` which can be used to obtain `Popup`s. Returns: Shared PopupFactory

### method:getPopup(java.awt.Component, java.awt.Component, int, int) [NONE]
- #### getPopup
      public Popup getPopup(Component owner,
                            Component contents,
                            int x,
                            int y)
                     throws IllegalArgumentException
Creates a `Popup` for the Component `owner` containing the Component `contents`. `owner` is used to determine which `Window` the new `Popup` will parent the `Component` the `Popup` creates to. A null `owner` implies there is no valid parent. `x` and `y` specify the preferred initial location to place the `Popup` at. Based on screen size, or other paramaters, the `Popup` may not display at `x` and `y`. Parameters: `owner` - Component mouse coordinates are relative to, may be null `contents` - Contents of the Popup `x` - Initial x screen coordinate `y` - Initial y screen coordinate Returns: Popup containing Contents Throws: `IllegalArgumentException` - if contents is null