Class Popup
java.lang.Object
javax.swing.Popup
Popups are used to display a
Component to the user, typically
on top of all the other Components in a particular containment
hierarchy. Popups have a very small life cycle. Once you
have obtained a Popup, and hidden it (invoked the
hide method), you should no longer
invoke any methods on it. This allows the PopupFactory to cache
Popups for later use.
The general contract is that if you need to change the size of the
Component, or location of the Popup, you should
obtain a new Popup.
Popup does not descend from Component, rather
implementations of Popup are responsible for creating
and maintaining their own Components to render the
requested Component to the user.
You typically do not explicitly create an instance of Popup,
instead obtain one from a PopupFactory.
- Since:
- 1.4
- See Also:
-
Constructor Summary
Constructors -
Method Summary
-
Constructor Details
-
Popup
Creates aPopupfor the Componentownercontaining the Componentcontents.owneris used to determine whichWindowthe newPopupwill parent theComponentthePopupcreates to. A nullownerimplies there is no valid parent.xandyspecify the preferred initial location to place thePopupat. Based on screen size, or other parameters, thePopupmay not display atxandy.- Parameters:
owner- Component mouse coordinates are relative to, may be nullcontents- Contents of the Popupx- Initial x screen coordinatey- Initial y screen coordinate- Throws:
IllegalArgumentException- if contents is null
-
Popup
protected Popup()Creates aPopup. This is provided for subclasses.
-
-
Method Details
-
show
public void show()Makes thePopupvisible. If thePopupis currently visible, this has no effect. -
hide
public void hide()Hides and disposes of thePopup. Once aPopuphas been disposed you should no longer invoke methods on it. AdisposedPopupmay be reclaimed and later used based on thePopupFactory. As such, if you invoke methods on adisposedPopup, indeterminate behavior will result.
-