PopupFactory JDK 1.6)

Description

public class PopupFactory

PopupFactory, as the name implies, is used to obtain instances of Popups.

PopupFactory, as the name implies, is used to obtain
instances of Popups. Popups are used to
display a Component above all other Components
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();

See also: Popup

Methods

Hide/Show inherited methods

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

Creates a Popup for the Component owner containing the Component contents.

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.
Returns: Popup containing Contents
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
Throws:
- IllegalArgumentException - if contents is null

pack-private int getPopupType ()

Returns the preferred type of Popup to create.

publicstatic PopupFactory getSharedInstance ()

Returns the shared PopupFactory which can be used to obtain Popups.

Returns the shared PopupFactory which can be used
to obtain Popups.
Returns: Shared PopupFactory

pack-private void setPopupType (int type)

Provides a hint as to the type of Popup that should be created.

publicstatic void setSharedInstance (PopupFactory factory)

Sets the PopupFactory that will be used to obtain Popups.

Sets the PopupFactory that will be used to obtain
Popups.
This will throw an IllegalArgumentException if
factory is null.
Parameters:
- factory - Shared PopupFactory
Throws:
- IllegalArgumentException - if factory is null
See Also: PopupFactory.getPopup(java.awt.Component, java.awt.Component, int, int),