Класс PopupFactory

java.lang.Object

javax.swing.PopupFactory

public class PopupFactory extends Object

PopupFactory, как следует из названия, используется для получения экземпляров Popups. Popups используются для отображения Component над всеми остальными Components в определённой иерархии контейнеров. Общее правило заключается в том, что после получения 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.

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

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 и Component, создаваемого Popup. Значение owner, равное null, означает, что допустимый родитель отсутствует. 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, будет использоваться в качестве родительского окна. Значение owner, равное null, означает, что допустимый родитель отсутствует. 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 — если содержимое равно 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.