Класс PopupFactory

java.lang.Object
- javax.swing.PopupFactory

public class PopupFactory
extends Object

PopupFactory, как следует из названия, используется для получения экземпляров Popup. Popup используются для отображения Component над всеми другими Component в определённой иерархии контейнера. Общий контракт заключается в том, что после получения Popup из PopupFactory, необходимо вызвать hide на Popup. Типичное использование:

PopupFactory factory = PopupFactory.getSharedInstance();
   Popup popup = factory.getPopup(owner, contents, x, y);
   popup.show();
   ...
   popup.hide();

Since:: 1.4
See Also:: Popup

Конструкторы

Конструктор	Описание
`PopupFactory()`

Методы

Модификатор и тип	Метод	Описание
`Popup`	`getPopup(Component owner, Component contents, int x, int y)`	Создаёт `Popup` для компонента `owner`, содержащего компонент `contents`.
`protected Popup`	`getPopup(Component owner, Component contents, int x, int y, boolean isHeavyWeightPopup)`	Создаёт `Popup` для компонента `owner`, содержащего компонент `contents`.
`static PopupFactory`	`getSharedInstance()`	Возвращает общий `PopupFactory`, который может быть использован для получения `Popup`.
`static void`	`setSharedInstance(PopupFactory factory)`	Устанавливает `PopupFactory`, который будет использоваться для получения `Popup`.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструкторы

PopupFactory

public PopupFactory()

Методы

setSharedInstance

public static void setSharedInstance(PopupFactory factory)

Устанавливает PopupFactory, который будет использоваться для получения Popup. Это выбросит IllegalArgumentException, если factory равно null.

Parameters:: factory - Общий PopupFactory
Throws:: IllegalArgumentException - если factory равно null
See Also:: getPopup(java.awt.Component, java.awt.Component, int, int)

getSharedInstance

public static PopupFactory getSharedInstance()

Возвращает общий PopupFactory, который может быть использован для получения Popup.

Returns:: Общий PopupFactory

getPopup

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

Создаёт Popup для компонента owner содержащего компонент contents . owner используется для определения того, каким Window новый Popup будет родительским для Component , который Popup создаёт. null owner подразумевает, что нет допустимого родителя. x и y задают предпочтительное начальное расположение для размещения Popup . В зависимости от размера экрана или других параметров, Popup может отображаться не по координатам x и y.

Parameters:: owner - Компонент, относительно которого определяются координаты мыши, может быть null; contents - Содержимое Popup; x - Начальная координата x на экране; y - Начальная координата y на экране
Returns:: Popup, содержащий содержимое
Throws:: IllegalArgumentException - если содержимое равно null

getPopup

protected Popup getPopup(Component owner,
                         Component contents,
                         int x,
                         int y,
                         boolean isHeavyWeightPopup)
                  throws IllegalArgumentException

Создаёт Popup для компонента owner содержащего компонент contents . Окно, содержащее компонент owner будет использоваться в качестве родительского окна. null owner подразумевает, что нет допустимого родителя. x и y задают предпочтительное начальное расположение для размещения Popup . В зависимости от размера экрана или других параметров, Popup может отображаться не по координатам x и y . isHeavyWeightPopup указывает, будет ли Popup иметь тяжёлую или лёгкую структуру. Передача true принудительно задаст Popup типу тяжёлую структуру, в противном случае тип Popup будет выбран фабрикой Popup. Лёгкие Popup окна более эффективны, чем тяжёлые (родной peer) окна, но лёгкие и тяжёлые компоненты плохо сочетаются в GUI. Этот метод предназначен для использования только подклассами PopupFactory.

Parameters:: owner - Компонент, относительно которого определяются координаты мыши, может быть null; contents - Содержимое Popup; x - Начальная координата x на экране; y - Начальная координата y на экране; isHeavyWeightPopup - true, если Popup должен быть тяжёлым, в противном случае тип Popup будет выбран Popup фабрикой.
Returns:: Popup, содержащий содержимое
Throws:: IllegalArgumentException - если содержимое равно null