Класс PopupFactory

java.lang.Object

javax.swing.PopupFactory

public class PopupFactory extends Object

PopupFactory, как следует из названия, используется для получения экземпляров Popups. Popups используются для отображения 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`s.
`static void`	`setSharedInstance(PopupFactory factory)`	Устанавливает `PopupFactory`, который будет использоваться для получения `Popup`s.

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

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

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

PopupFactory

public PopupFactory()

Создаёт PopupFactory.

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

setSharedInstance

public static void setSharedInstance(PopupFactory factory)

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

Параметры:

factory — общая фабрика PopupFactory

Вызывает исключение:

IllegalArgumentException — если factory равен null

См. также:

getSharedInstance

public static PopupFactory getSharedInstance()

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

Возвращает:: Общая фабрика PopupFactory

getPopup

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

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

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

Параметры:: owner — компонент, относительно которого заданы координаты мыши; может быть null; contents — содержимое Popup; x — начальная экранная координата x; y — начальная экранная координата y; isHeavyWeightPopup — true, если Popup должен быть тяжеловесным; в противном случае тип Popup будет выбран фабрикой Popup.
Возвращает:: Popup, содержащий содержимое
Вызывает исключение:: IllegalArgumentException — если contents равен 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/PopupFactory.html