Класс 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();

С момента:

1.4

См. также:

Краткое описание конструкторов

Конструктор	Описание
`PopupFactory()`	Создаёт `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()

Создаёт PopupFactory.

Подробное описание методов

setSharedInstance

public static void setSharedInstance(PopupFactory factory)

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

Параметры:

factory - Общий PopupFactory

Исключения:

IllegalArgumentException - если factory равно null

См. также:

getSharedInstance

public static PopupFactory getSharedInstance()

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

Возвращает:: Общий 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.

Параметры:: owner - Компонент, относительно которого определяются координаты мыши, может быть null; contents - Содержимое Popup; x - Начальная координата x на экране; y - Начальная координата y на экране
Возвращает:: Popup, содержащий содержимое
Исключения:: 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 окна более эффективны, чем тяжёлые (родные) окна, но лёгковесные и тяжёлые компоненты плохо взаимодействуют в графическом интерфейсе. Этот метод предназначен для использования только подклассами PopupFactory.

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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/PopupFactory.html