Класс Window

public Window(Frame owner)

Создаёт новое, изначально невидимое окно с указанным Frame в качестве владельца. Окно не будет фокусируемым, если его владелец не отображается на экране.

Если установлен менеджер безопасности, он вызывается для проверки AWTPermission("showWindowWithoutWarningBanner"). Если проверка завершается неудачно с SecurityException, создаётся баннер с предупреждением.

public Window(Window owner)

Создаёт новое, изначально невидимое окно с указанным Window в качестве владельца. Это окно не будет фокусируемым, если ближайший владелец Frame или Dialog не отображается на экране.

Если установлен менеджер безопасности, он вызывается для проверки AWTPermission("showWindowWithoutWarningBanner"). Если проверка завершается неудачно с SecurityException, создаётся баннер с предупреждением.

public Window(Window owner, GraphicsConfiguration gc)

Создаёт новое, изначально невидимое окно с указанным владельцем Window и GraphicsConfiguration устройства отображения. Окно не будет фокусируемым, если ближайший владелец Frame или Dialog не отображается на экране.

Если установлен менеджер безопасности, он вызывается для проверки AWTPermission("showWindowWithoutWarningBanner"). Если проверка завершается неудачно с SecurityException, создаётся баннер с предупреждением.

public List<Image> getIconImages()

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

Этот метод возвращает копию внутреннего списка, поэтому все операции с возвращённым объектом не повлияют на поведение окна.

public void setIconImages(List<? extends Image> icons)

Устанавливает последовательность изображений, которые должны отображаться в качестве значка этого окна. Последующие вызовы getIconImages всегда возвращают копию icons списка.

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

Список icons может содержать MultiResolutionImage изображения. Подходящее изображение в зависимости от разрешения экрана извлекается из базового изображения MultiResolutionImage и добавляется в список значков, при этом базовая разрешение изображения удаляется из списка. Список icons сканируется в поисках изображений наиболее подходящих размеров с начала. Если список содержит несколько изображений одинакового размера, используется первое.

Окна без владельца, для которых не указан значок, используют значок по умолчанию платформы. Значок окна-потомка может быть унаследован от владельца, если явно не переопределён. Установка значка в null или пустой список восстанавливает поведение по умолчанию.

Примечание: Системы с собственными окнами могут использовать разные изображения разных размеров для представления окна в зависимости от контекста (например, декорирования окна, списка окон, панели задач и т. д.). Они также могут использовать только одно изображение для всех контекстов или вообще не использовать изображение.

public void setIconImage(Image image)

Устанавливает изображение, которое должно отображаться в качестве значка для этого окна.

Этот метод может быть использован вместо setIconImages() для указания одного изображения в качестве значка окна.

Следующее утверждение:

     setIconImage(image);
 

эквивалентно:

     ArrayList<Image> imageList = new ArrayList<Image>();
     imageList.add(image);
     setIconImages(imageList);
 

Примечание: Системы с собственными окнами могут использовать разные изображения разных размеров для представления окна в зависимости от контекста (например, декорирования окна, списка окон, панели задач и т. д.). Они также могут использовать только одно изображение для всех контекстов или вообще не использовать изображение.

public void addNotify()

Делает это окно отображаемым, создавая соединение с его системным ресурсом на экране. Этот метод вызывается внутри инструментарием и не должен вызываться напрямую программами.

public void pack()

Изменяет размер этого окна для соответствия предпочтительным размерам и макетам его дочерних компонентов. Результирующая ширина и высота окна автоматически увеличиваются, если любая из этих величин меньше минимального размера, как указано в предыдущем вызове метода setMinimumSize.

Если окно и/или его владелец ещё не отображаются, оба из них делаются отображаемыми перед расчётом предпочтительного размера. Окно валидируется после расчёта его размера.

public void setMinimumSize(Dimension minimumSize)

Устанавливает минимальный размер этого окна в постоянное значение. Последующие вызовы getMinimumSize всегда возвращают это значение. Если текущий размер окна меньше minimumSize, размер окна автоматически увеличивается для соблюдения минимального размера.

Если методы setSize или setBounds вызываются позже со значениями ширины или высоты, меньшими, чем заданное методом setMinimumSize, окно автоматически увеличивается для соответствия значению minimumSize. Значение minimumSize также влияет на поведение метода pack.

Поведение по умолчанию восстанавливается, если установить параметр минимального размера в значение null.

Операции изменения размера могут быть ограничены, если пользователь пытается уменьшить размер окна ниже значения minimumSize. Это поведение зависит от платформы.

public void setSize(Dimension d)

Изменяет размеры этого компонента на ширину d.width и высоту d.height.

Этот метод изменяет информацию, связанную с макетом, и поэтому делает недействительным иерархию компонентов.

Значения d.width и d.height автоматически увеличиваются, если они меньше минимального размера, указанного предыдущим вызовом setMinimumSize.

Метод изменяет геометрические данные. Поэтому система окон может игнорировать такие запросы или может изменить запрошенные данные, чтобы объект Window был размещен и изменен таким образом, чтобы соответствовать настройкам рабочего стола.

public void setSize(int width, int height)

Изменяет размеры этого компонента на ширину width и высоту height.

Этот метод изменяет информацию, связанную с макетом, и поэтому делает недействительным иерархию компонентов.

Значения width и height автоматически увеличиваются, если они меньше минимального размера, указанного предыдущим вызовом setMinimumSize.

Метод изменяет геометрические данные. Поэтому система окон может игнорировать такие запросы или может изменить запрошенные данные, чтобы объект Window был размещен и изменен таким образом, чтобы соответствовать настройкам рабочего стола.

public void setLocation(int x, int y)

Перемещает этот компонент в новое положение. Верхний левый угол нового положения задаётся параметрами x и y в пространстве координат родителя этого компонента.

Этот метод изменяет информацию, связанную с макетом, и поэтому делает недействительным иерархию компонентов.

Метод изменяет геометрические данные. Поэтому система окон может игнорировать такие запросы или может изменить запрошенные данные, чтобы объект Window был размещен и изменен таким образом, чтобы соответствовать настройкам рабочего стола.

public void setLocation(Point p)

Перемещает этот компонент в новое положение. Верхний левый угол нового положения задаётся точкой p. Точка p задана в пространстве координат родителя.

Этот метод изменяет информацию, связанную с макетом, и поэтому делает недействительным иерархию компонентов.

Метод изменяет геометрические данные. Поэтому система окон может игнорировать такие запросы или может изменить запрошенные данные, чтобы объект Window был размещен и изменен таким образом, чтобы соответствовать настройкам рабочего стола.

@Deprecated public void reshape(int x, int y, int width, int height)

Изменяет прямоугольник границ для этого компонента.

public void setVisible(boolean b)

Показывает или скрывает этот Window в зависимости от значения параметра b.

Если метод отображает окно, то окно также фокусируется в следующих условиях:

• Окно Window удовлетворяет требованиям, изложенным в методе isFocusableWindow().
• Свойство Window окна autoRequestFocus имеет значение true.
• Система окон позволяет окну Window получить фокус.

Существует исключение для второго условия (значение свойства autoRequestFocus). Свойство не учитывается, если окно является модальным диалоговым окном, которое блокирует окно, имеющее фокус в данный момент.

Разработчики не должны предполагать, что окно имеет фокус или активно, пока оно не получит событие WINDOW_GAINED_FOCUS или WINDOW_ACTIVATED.

@Deprecated public void show()

Делает окно видимым. Если окно и/или его владелец еще не отображаются, оба делаются отображаемыми. Окно будет проверено перед тем, как стать видимым. Если окно уже видно, это выведет окно на передний план.

@Deprecated public void hide()

Скрыть это окно, его подкомпоненты и все его подчиненные дочерние элементы. Окно и его подкомпоненты можно сделать видимыми снова с помощью вызова show.

public void dispose()

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

Этот Window и его подкомпоненты могут быть снова отображены, перестроив системные ресурсы с последующим вызовом pack или show. Состояния воссозданных Window и его подкомпонентов будут идентичны состояниям этих объектов в момент, когда этот Window был закрыт (не учитывая дополнительных изменений между этими действиями).

Примечание: При закрытии последнего отображаемого окна в виртуальной машине Java (VM), VM может завершиться. См. Вопросы многопоточности AWT для получения дополнительной информации.

public void toFront()

Если это окно отображается, перемещает это окно вперёд и может сделать его активным.

Размещает это окно вверху стека и отображает его поверх всех других окон в этой виртуальной машине. Действий не будет, если это окно не отображается. Некоторые платформы не позволяют окнам, которые содержат другие окна, отображаться поверх этих содержащихся окон. Некоторые платформы могут не разрешить этой виртуальной машине размещать свои окна поверх окон приложений нативного уровня или окон других виртуальных машин. Это разрешение может зависеть от того, является ли уже окно в этой виртуальной машине активным. Будет сделана вся попытка переместить это окно как можно выше в стеке; однако разработчики не должны предполагать, что этот метод разместит это окно поверх всех других окон в любой ситуации.

Разработчики никогда не должны предполагать, что это окно является активным, пока это окно не получит событие WINDOW_GAINED_FOCUS или WINDOW_ACTIVATED. На платформах, где окно сверху является активным, этот метод, скорее всего, сделает это окно активным (если оно им уже не является), при следующих условиях:

• Окно соответствует требованиям, изложенным в методе isFocusableWindow().
• Свойство окна autoRequestFocus имеет значение true.
• Система оконного менеджера позволяет окну получить фокус.

На платформах, где порядок стека обычно не влияет на активное окно, этот метод, скорее всего, оставит активное окно без изменений.

Если этот метод делает это окно активным, и это окно является окном-рамкой или диалоговым окном, оно также будет активировано. Если это окно является активным, но не является окном-рамкой или диалоговым окном, то первое окно-рамка или диалоговое окно, являющееся собственником этого окна, будет активировано.

Если это окно заблокировано модальным диалоговым окном, то блокирующее диалоговое окно перемещается вперёд и остается поверх заблокированного окна.

public void toBack()

Если это окно отображается, перемещает это окно назад и может привести к потере фокуса или активации, если это активное окно.

Размещает это окно внизу стека и отображает его позади других окон в этой виртуальной машине. Действий не будет, если это окно не отображается. Некоторые платформы не позволяют окнам, являющимся дочерними для других окон, отображаться ниже их родителей. Будет сделана вся попытка переместить это окно как можно ниже в стеке; однако разработчики не должны предполагать, что этот метод разместит это окно ниже всех других окон в любой ситуации.

Из-за вариаций в системах окон нативного уровня, нельзя гарантировать изменений в фокусе и активации окон. Разработчики никогда не должны предполагать, что это окно больше не является активным, пока это окно не получит событие WINDOW_LOST_FOCUS или WINDOW_DEACTIVATED. На платформах, где верхнее окно является активным, этот метод, скорее всего, приведет к потере фокуса этим окном. В этом случае фокус получит следующее активное окно в этой виртуальной машине. На платформах, где порядок стека обычно не влияет на активное окно, этот метод, скорее всего, оставит активное окно без изменений.

public Toolkit getToolkit()

Возвращает набор инструментов этого кадра.

public final String getWarningString()

Получает строку предупреждения, отображаемую с этим окном. Если это окно небезопасно, строка предупреждения отображается где-то в видимой области окна. Окно небезопасно, если существует менеджер безопасности, и менеджер безопасности отказывается от AWTPermission("showWindowWithoutWarningBanner").

Если окно безопасно, то getWarningString возвращает null. Если окно небезопасно, этот метод проверяет системную переменную awt.appletWarning и возвращает строковое значение этой переменной.

public Locale getLocale()

Получает объект Locale , связанный с этим окном, если локаль была установлена. Если локаль не была установлена, возвращается локаль по умолчанию.

public InputContext getInputContext()

Получает контекст ввода для этого окна. У окна всегда есть контекст ввода, который совместно используется подкомпонентами, если они не создают и не устанавливают свой собственный.

public void setCursor(Cursor cursor)

Устанавливает изображение курсора на указанный курсор.

Метод может не иметь визуального эффекта, если реализация платформы Java и/или нативная система не поддерживают изменение формы курсора мыши.

public Window getOwner()

Возвращает владельца этого окна.

public Window[] getOwnedWindows()

Возвращает массив, содержащий все окна, которые в данный момент принадлежат этому окну.

public static Window[] getWindows()

Возвращает массив всех Window , как принадлежащих, так и без владельца, созданных этим приложением. Если вызывается из апплета, массив содержит только Window , доступные этому апплету.

Предупреждение: этот метод может вернуть окна, созданные системой, такие как диалог печати. Приложения не должны предполагать существования этих диалогов, и приложение не должно ничего предполагать об этих диалогах, таких как положения компонентов, LayoutManager или сериализации.

public static Window[] getOwnerlessWindows()

Возвращает массив всех Window , созданных этим приложением и не имеющих владельца. Они включают в себя Frame и безвладельных Dialog и Window. Если вызывается из апплета, массив содержит только Window , доступные этому апплету.

Предупреждение: этот метод может вернуть окна, созданные системой, такие как диалог печати. Приложения не должны предполагать существования этих диалогов, и приложение не должно ничего предполагать об этих диалогах, таких как положения компонентов, LayoutManager или сериализации.

public void setModalExclusionType(Dialog.ModalExclusionType exclusionType)

Задает тип исключения модального режима для этого окна. Если окно исключено из модального режима, оно не блокируется некоторыми модальными диалогами. См. Dialog.ModalExclusionType для возможных типов исключения модального режима.

Если заданный тип не поддерживается, используется NO_EXCLUDE.

Примечание: изменение типа исключения модального режима для видимого окна может не иметь эффекта, пока оно не будет скрыто и снова показано.

public Dialog.ModalExclusionType getModalExclusionType()

Возвращает тип исключения модального режима этого окна.

public void addWindowListener(WindowListener l)

Добавляет указанный прослушиватель событий окна для получения событий окна из этого окна. Если l равно null, исключение не выбрасывается и никакие действия не выполняются.

Обратитесь к AWT Threading Issues для получения подробной информации о модели многопоточности AWT.

public void addWindowStateListener(WindowStateListener l)

Добавляет указанный прослушиватель состояния окна для получения событий окна из этого окна. Если l равно null, исключение не выбрасывается и никакие действия не выполняются.

Обратитесь к AWT Threading Issues для получения подробной информации о модели многопоточности AWT.

public void addWindowFocusListener(WindowFocusListener l)

Добавляет указанный прослушиватель фокуса окна для получения событий окна из этого окна. Если l равно null, исключение не выбрасывается и никакие действия не выполняются.

Обратитесь к AWT Threading Issues для получения подробной информации о модели многопоточности AWT.

public void removeWindowListener(WindowListener l)

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

Обратитесь к AWT Threading Issues для получения подробной информации о модели многопоточности AWT.

public void removeWindowStateListener(WindowStateListener l)

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

Обратитесь к AWT Threading Issues для получения подробной информации о модели многопоточности AWT.

public void removeWindowFocusListener(WindowFocusListener l)

Удаляет указанный прослушиватель фокуса окна, так что он больше не получает события окна из этого окна. Если l равно null, исключение не выбрасывается и никакие действия не выполняются.

Обратитесь к AWT Threading Issues для получения подробной информации о модели многопоточности AWT.

public WindowListener[] getWindowListeners()

Возвращает массив всех прослушивателей событий окна, зарегистрированных в этом окне.

public WindowFocusListener[] getWindowFocusListeners()

Возвращает массив всех прослушивателей фокуса окна, зарегистрированных в этом окне.

public WindowStateListener[] getWindowStateListeners()

Возвращает массив всех прослушивателей состояния окна, зарегистрированных в этом окне.

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Возвращает массив всех объектов, в настоящее время зарегистрированных как FooListener в этом Window. FooListener регистрируются с помощью метода addFooListener.

Вы можете указать аргумент listenerType с помощью литерала класса, например FooListener.class. Например, вы можете запросить Window w для его прослушивателей событий окна с помощью следующего кода:

WindowListener[] wls = (WindowListener[])(w.getListeners(WindowListener.class));

Если таких прослушивателей не существует, этот метод возвращает пустой массив.

protected void processEvent(AWTEvent e)

Обрабатывает события в этом окне. Если событие является WindowEvent, вызывается метод processWindowEvent, в противном случае вызывается метод родительского класса processEvent.

Обратите внимание, что если параметр события null, поведение не определено и может привести к исключению.

protected void processWindowEvent(WindowEvent e)

Обрабатывает события окна, происходящие в этом окне, рассылая их зарегистрированным объектам WindowListener. ПРИМЕЧАНИЕ: Этот метод не будет вызван, если события окна не включены для этого компонента; это происходит, когда происходит одно из следующих событий:

• Объект WindowListener зарегистрирован через addWindowListener
• События окна включены через enableEvents

Обратите внимание, что если параметр события null, поведение не определено и может привести к исключению.

protected void processWindowFocusEvent(WindowEvent e)

Обрабатывает событие фокуса окна, происходящее в этом окне, рассылая их зарегистрированным объектам WindowFocusListener. ПРИМЕЧАНИЕ: этот метод не будет вызван, если события фокуса окна не включены для этого окна. Это происходит, когда происходит одно из следующих событий:

• WindowFocusListener зарегистрирован через addWindowFocusListener
• События фокуса окна включены через enableEvents

Обратите внимание, что если параметр события null, поведение не определено и может привести к исключению.

protected void processWindowStateEvent(WindowEvent e)

Обрабатывает событие состояния окна, происходящее в этом окне, рассылая их зарегистрированным объектам WindowStateListener. ПРИМЕЧАНИЕ: этот метод не будет вызван, если события состояния окна не включены для этого окна. Это происходит, когда происходит одно из следующих событий:

• объект WindowStateListener зарегистрирован через addWindowStateListener
• события состояния окна включены через enableEvents

Обратите внимание, что если параметр события null, поведение не определено и может привести к исключению.

public final void setAlwaysOnTop(boolean alwaysOnTop) throws SecurityException

Устанавливает, должно ли это окно всегда быть сверху других окон. Если существует несколько окон всегда-сверху, их относительный порядок не определен и зависит от платформы.

Если другое окно уже всегда сверху, то относительный порядок между этими окнами не определен (зависит от платформы). Никакое окно не может быть помещено поверх окна всегда-сверху, кроме, возможно, другого окна всегда-сверху.

Все окна, принадлежащие окну всегда-сверху, наследуют этот статус и автоматически становятся всегда-сверху. Если окно перестает быть всегда-сверху, окна, которые ему принадлежат, больше не будут всегда-сверху. Когда окно всегда-сверху отправляется toBack, его статус всегда-сверху устанавливается в false.

Когда этот метод вызывается для окна со значением true, и окно видимое, а платформа поддерживает всегда-сверху для этого окна, окно немедленно выводится вперёд, "прикрепляясь" к верхней позиции. Если окно невидимо, этот метод устанавливает статус всегда-сверху в true но не выводит окно вперед. Когда окно позже будет показано, оно будет всегда-сверху.

Когда этот метод вызывается для окна со значением false, статус всегда-сверху устанавливается в нормальный. Он также может вызвать неопределённое, зависящее от платформы, изменение порядка окон верхнего уровня, но другие окна всегда-сверху останутся в верхней позиции. Вызов этого метода со значением false для окна в нормальном состоянии не имеет эффекта.

Примечание: некоторые платформы могут не поддерживать окна всегда-сверху. Чтобы определить, поддерживает ли текущая платформа окна всегда-сверху, используйте Toolkit.isAlwaysOnTopSupported() и isAlwaysOnTopSupported(). Если режим всегда-сверху не поддерживается для этого окна или среда выполнения этого окна не поддерживает окна всегда-сверху, вызов этого метода не окажет никакого влияния.

Если установлен SecurityManager, вызывающей нити необходимо предоставить разрешение AWTPermission "setWindowAlwaysOnTop", чтобы установить значение этого свойства. Если это разрешение не предоставлено, этот метод выбросит SecurityException, и текущее значение свойства останется неизменным.

public boolean isAlwaysOnTopSupported()

Возвращает, поддерживается ли режим всегда-сверху для этого окна. Некоторые платформы могут не поддерживать окна всегда-сверху, некоторые могут поддерживать только некоторые типы окон верхнего уровня; например, платформа может не поддерживать модальные диалоговые окна всегда-сверху.

public final boolean isAlwaysOnTop()

Возвращает, является ли это окно окном всегда-сверху.

public Component getFocusOwner()

Возвращает дочерний компонент этого окна, у которого есть фокус, если этому окну принадлежит фокус; в противном случае возвращает null.

public Component getMostRecentFocusOwner()

Возвращает дочерний компонент этого окна, которому будет передан фокус, когда этому окну принадлежит фокус. Если этому окну в настоящее время принадлежит фокус, этот метод возвращает тот же компонент, что и getFocusOwner(). Если этому окну не принадлежит фокус, возвращается дочерний компонент, который последним запросил фокус. Если ни один дочерний компонент никогда не запрашивал фокус, и это фокусируемое окно, возвращается начальный фокусируемый компонент этого окна. Если ни один дочерний компонент никогда не запрашивал фокус, и это не фокусируемое окно, возвращается null.

public boolean isActive()

Возвращает, является ли это окно активным. Только Frame или Dialog могут быть активными. Система отображения может обозначать активное окно или его дочерние элементы специальными декорациями, такими как выделенная строка заголовка. Активное окно всегда является либо фокусированным окном, либо первым Frame или Dialog, являющимся владельцем фокусированного окна.

public boolean isFocused()

Возвращает, сосредоточен ли на данном окне. Если существует владелец фокуса, сосредоточенным окном является окно, которое имеет или содержит этот владелец фокуса. Если нет владельца фокуса, то ни одно окно не сосредоточено.

Если сосредоточенное окно является рамкой или диалоговым окном, то оно также является активным окном. В противном случае активным окном является первая рамка или диалоговое окно, которая является владельцем сосредоточенного окна.

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

Получает клавишу перехода фокуса для данного окна. (См. setFocusTraversalKeys для полного описания каждой клавиши).

Если клавиша перехода не была явно установлена для данного окна, возвращается клавиша перехода родительского окна. Если клавиша перехода не была явно установлена для какого-либо предка данного окна, возвращается значение по умолчанию для текущего менеджера клавиатурного фокуса.

public final void setFocusCycleRoot(boolean focusCycleRoot)

Не делает ничего, так как окна должны всегда быть корнями цикла перехода фокуса. Передаваемое значение игнорируется.

public final boolean isFocusCycleRoot()

Всегда возвращает true, так как все окна должны быть корнями цикла перехода фокуса.

public final Container getFocusCycleRootAncestor()

Всегда возвращает null, так как окна не имеют предков; они представляют собой вершину иерархии компонентов.

public final boolean isFocusableWindow()

Возвращает, может ли это окно стать сосредоточенным окном, то есть, может ли это окно или любой из его подкомпонентов стать владельцем фокуса. Для того, чтобы рамка или диалоговое окно были доступны для получения фокуса, состояние доступности окна для фокуса должно быть установлено в true. Для окна, которое не является рамкой или диалоговым окном, чтобы оно было доступно для получения фокуса, состояние доступности окна для фокуса должно быть установлено в true, ближайшая владеющая рамка или диалоговое окно должны отображаться на экране, и оно должно содержать по крайней мере один компонент в цикле перехода фокуса. Если какое-либо из этих условий не выполняется, ни это окно, ни один из его подкомпонентов не могут стать владельцем фокуса.

public boolean getFocusableWindowState()

Возвращает, может ли данное окно стать сосредоточенным, если оно удовлетворяет другим требованиям, описанным в isFocusableWindow. Если этот метод возвращает false, то isFocusableWindow также вернет false. Если этот метод возвращает true, то isFocusableWindow может вернуть true или false в зависимости от других требований, которые должны быть выполнены для того, чтобы окно было доступно для фокуса.

По умолчанию все окна имеют состояние доступности для фокуса true.

public void setFocusableWindowState(boolean focusableWindowState)

Устанавливает, может ли это окно стать сосредоточенным, если оно удовлетворяет другим требованиям, описанным в isFocusableWindow. Если состояние доступности окна для фокуса этого окна установлено в false, то isFocusableWindow вернет false. Если состояние доступности окна для фокуса этого окна установлено в true, то isFocusableWindow может вернуть true или false в зависимости от других требований, которые должны быть выполнены для того, чтобы окно было доступно для фокуса.

Установка состояния доступности окна для фокуса в false — это стандартный механизм, который приложение использует для того, чтобы уведомить AWT о том, что окно будет использоваться как плавающая палитра или панель инструментов, и, следовательно, должно быть недоступно для фокуса. Установка состояния доступности фокуса для видимого Window может иметь отложенный эффект на некоторых платформах — фактическое изменение может произойти только тогда, когда Window скроется, а затем снова станет видимым. Чтобы обеспечить согласованное поведение на всех платформах, установите состояние доступности фокуса для Window, когда Window невидимо, а затем покажите его.

public void setAutoRequestFocus(boolean autoRequestFocus)

Устанавливает, должно ли это окно получать фокус при последующем отображении (с вызовом setVisible(true)) или перемещении вперёд (с вызовом toFront()).

Обратите внимание, что setVisible(true) может вызываться косвенно (например, при отображении владельца окна, что заставляет окно отображаться). toFront() также может вызываться косвенно (например, при вызове setVisible(true) на уже видимом окне). Во всех таких случаях это свойство также действует.

Значение свойства не наследуется дочерними окнами.

public boolean isAutoRequestFocus()

Возвращает, должно ли это окно получать фокус при последующем отображении (с вызовом setVisible(true)) или перемещении вперёд (с вызовом toFront()).

По умолчанию окно имеет значение autoRequestFocus true.

public void addPropertyChangeListener(PropertyChangeListener listener)

Добавляет обработчик PropertyChangeListener в список слушателей. Слушатель регистрируется для всех связанных свойств этого класса, включая следующие:

• шрифт этого окна ("font")
• цвет фона этого окна ("background")
• цвет текста этого окна ("foreground")
• возможность получения фокуса этого окна ("focusable")
• состояние активации клавиш перехода фокуса ("focusTraversalKeysEnabled")
• набор клавиш перехода фокуса вперед ("forwardFocusTraversalKeys")
• набор клавиш перехода фокуса назад ("backwardFocusTraversalKeys")
• набор клавиш перехода фокуса вверх ("upCycleFocusTraversalKeys")
• набор клавиш перехода фокуса вниз ("downCycleFocusTraversalKeys")
• политика перехода фокуса ("focusTraversalPolicy")
• состояние фокусируемого окна ("focusableWindowState")
• состояние всегда-сверху ("alwaysOnTop")

Обратите внимание, что если это окно наследует связанное свойство, то событие не будет сгенерировано в ответ на изменение наследуемого свойства.

Если listener равен null, то исключение не выбрасывается и никаких действий не выполняется.

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

Добавляет обработчик PropertyChangeListener в список слушателей для определенного свойства. Указанное свойство может быть пользовательским или одним из следующих:

• шрифт этого окна ("font")
• цвет фона этого окна ("background")
• цвет текста этого окна ("foreground")
• возможность получения фокуса этого окна ("focusable")
• состояние активации клавиш перехода фокуса ("focusTraversalKeysEnabled")
• набор клавиш перехода фокуса вперед ("forwardFocusTraversalKeys")
• набор клавиш перехода фокуса назад ("backwardFocusTraversalKeys")
• набор клавиш перехода фокуса вверх ("upCycleFocusTraversalKeys")
• набор клавиш перехода фокуса вниз ("downCycleFocusTraversalKeys")
• политика перехода фокуса ("focusTraversalPolicy")
• состояние фокусируемого окна ("focusableWindowState")
• состояние всегда-сверху ("alwaysOnTop")

Обратите внимание, что если это окно наследует связанное свойство, то событие не будет сгенерировано в ответ на изменение наследуемого свойства.

Если listener равен null, то исключение не выбрасывается и никаких действий не выполняется.

public boolean isValidateRoot()

Указывает, является ли этот контейнер корневым объектом для валидации.

Объекты Window являются корневыми объектами для валидации и, следовательно, переопределяют этот метод, возвращая true.

@Deprecated public boolean postEvent(Event e)

Отправляет событие слушателям.

public boolean isShowing()

Проверяет, отображается ли это окно на экране.

public void setType(Window.Type type)

Устанавливает тип окна. Этот метод может быть вызван только пока окно не отображается.

public Window.Type getType()

Возвращает тип окна.

public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим окном. Для окон AccessibleContext имеет вид AccessibleAWTWindow. Новый AccessibleAWTWindow создается при необходимости.

public void setLocationRelativeTo(Component c)

Устанавливает расположение окна относительно указанного компонента в соответствии со следующими сценариями.

Цель экрана, упомянутая ниже, - это экран, на который должно быть помещено окно после вызова метода setLocationRelativeTo.

• Если компонент является null, или GraphicsConfiguration , связанный с этим компонентом, равен null, окно размещается в центре экрана. Точка центра может быть получена с помощью метода GraphicsEnvironment.getCenterPoint.
• Если компонент не null, но он не отображается, окно размещается в центре целевого экрана, определенного GraphicsConfiguration , связанного с этим компонентом.
• Если компонент не null и отображается на экране, то окно размещается таким образом, что центр окна совпадает с центром компонента.

Если конфигурация экранов не позволяет перемещать окно с одного экрана на другой, то окно размещается только в позиции, определенной по вышеуказанным условиям, и его GraphicsConfiguration не изменяется.

Примечание: Если нижний край окна выходит за пределы экрана, то окно помещается на сторону Component , которая ближе к центру экрана. Итак, если компонент находится в правой части экрана, окно помещается слева, и наоборот.

Если после вычисления расположения окна верхний, левый или правый край окна выходит за пределы экрана, то окно размещается таким образом, что верхний, левый или правый край окна совпадает с соответствующим краем экрана. Если оба левых и правых края окна выходят за пределы экрана, окно размещается слева от экрана. Аналогичное размещение произойдет, если оба верхний и нижний края выходят за пределы экрана. В этом случае окно размещается в верхней части экрана.

Метод изменяет данные, относящиеся к геометрии. Поэтому система управления окнами может игнорировать такие запросы или изменить запрошенные данные, чтобы объект Window был размещен и размером таким образом, чтобы соответствовать настройкам рабочего стола.

public void createBufferStrategy(int numBuffers)

Создаёт новую стратегию для многобуферного отображения на этом компоненте. Многобуферность полезна для производительности отрисовки. Этот метод пытается создать лучшую доступную стратегию с заданным количеством буферов. Он всегда создаёт стратегию с указанным количеством буферов. Сначала используется стратегия перелистывания страниц, затем стратегия с использованием ускоренных буферов, и наконец, используется неускоренная стратегия с использованием буферов.

Каждый раз, когда вызывается этот метод, существующая стратегия буферизации для этого компонента отбрасывается.

public void createBufferStrategy(int numBuffers, BufferCapabilities caps) throws AWTException

Создаёт новую стратегию для многобуферного отображения на этом компоненте с необходимыми возможностями буферов. Это полезно, например, если требуется только ускоренная память или перелистывание страниц (как указано в возможностях буфера).

Каждый раз, когда вызывается этот метод, существующая стратегия буферизации для этого компонента отбрасывается.

public BufferStrategy getBufferStrategy()

Возвращает стратегию буферизации, используемую этим компонентом. Этот метод вернёт null, если стратегия буферизации ещё не создана или была удалена.

public void setLocationByPlatform(boolean locationByPlatform)

Устанавливает, должен ли этот объект Window отображаться по умолчанию для нативной системы окон или по текущим координатам (возвращаемым getLocation) при следующем отображении. Это поведение напоминает поведение нативного окна, показанного без программирования его расположения. Большинство систем окон располагают окна каскадно, если их расположение не задано явно. Фактическое расположение определяется после отображения окна на экране.

Это поведение также можно включить, установив системную переменную "java.awt.Window.locationByPlatform" в "true", хотя вызовы этого метода имеют приоритет.

Вызовы setVisible, setLocation и setBounds после вызова setLocationByPlatform очищают эту свойство окна.

Например, после выполнения следующего кода:

 setLocationByPlatform(true);
 setVisible(true);
 boolean flag = isLocationByPlatform();
 

Окно будет отображаться по умолчанию для платформы, и flag будет false.

В следующем примере:

 setLocationByPlatform(true);
 setLocation(10, 10);
 boolean flag = isLocationByPlatform();
 setVisible(true);
 

Окно будет отображено в (10, 10), и flag будет false.

public boolean isLocationByPlatform()

Возвращает true если это окно будет отображаться по умолчанию для нативной системы окон при следующем отображении. Этот метод всегда возвращает false если окно отображается на экране.

public void setBounds(int x, int y, int width, int height)

Перемещает и изменяет размер этого компонента. Новое расположение верхнего левого угла задаётся x и y, а новый размер — width и height.

Этот метод изменяет информацию, связанную с макетом, и поэтому делает недействительной иерархию компонента.

Значения width или height автоматически увеличиваются, если любое из них меньше минимального размера, заданного предыдущим вызовом setMinimumSize.

Метод изменяет данные, связанные с геометрией. Поэтому нативная система окон может игнорировать такие запросы или изменить запрошенные данные, чтобы объект Window был размещён и изменён в размере, который соответствует настройкам рабочего стола.

public void setBounds(Rectangle r)

Перемещает и изменяет размер этого компонента, чтобы соответствовать новой области r. Новое расположение компонента задаётся r.x и r.y, а его новый размер — r.width и r.height.

Этот метод изменяет информацию, связанную с макетом, и поэтому делает недействительной иерархию компонента.

Значения r.width или r.height автоматически увеличиваются, если любое из них меньше минимального размера, заданного предыдущим вызовом setMinimumSize.

Метод изменяет данные, связанные с геометрией. Поэтому нативная система окон может игнорировать такие запросы или изменить запрошенные данные, чтобы объект Window был размещён и изменён в размере, который соответствует настройкам рабочего стола.

public float getOpacity()

Возвращает непрозрачность окна.

public void setOpacity(float opacity)

Устанавливает непрозрачность окна.

Значение непрозрачности находится в диапазоне [0..1]. Обратите внимание, что установка уровня непрозрачности 0 может или не может отключить обработку событий мыши в этом окне. Это зависит от платформы.

Для установки значения непрозрачности меньше 1.0f должны быть выполнены следующие условия:

• Прозрачность TRANSLUCENT должна поддерживаться основной системой
• Окно должно быть без оформления (см. Frame.setUndecorated(boolean) и Dialog.setUndecorated(boolean))
• Окно не должно быть в полноэкранном режиме (см. GraphicsDevice.setFullScreenWindow(Window))

Если запрошенное значение непрозрачности меньше 1.0f, и любое из вышеперечисленных условий не выполняется, непрозрачность окна не изменится, и будет выброшено исключение IllegalComponentStateException.

Уровни прозрачности отдельных пикселей также могут зависеть от альфа-компонента их цвета (см. setBackground(Color)) и текущей формы этого окна (см. setShape(Shape)).

public Shape getShape()

Возвращает форму окна. Возвращаемое значение этого метода может отличаться от ранее установленного с помощью setShape(shape), но гарантированно представляет ту же форму.

public void setShape(Shape shape)

Устанавливает форму окна.

Установка формы обрезает некоторые части окна. Видимыми и кликабельными остаются только части, принадлежащие заданной Shape. Если аргумент shape равен null, этот метод восстанавливает форму по умолчанию, делая окно прямоугольным на большинстве платформ.

Для установки непустой формы должны быть выполнены следующие условия:

• Прозрачность PERPIXEL_TRANSPARENT должна поддерживаться основной системой
• Окно должно быть без оформления (см. Frame.setUndecorated(boolean) и Dialog.setUndecorated(boolean))
• Окно не должно быть в полноэкранном режиме (см. GraphicsDevice.setFullScreenWindow(Window))

Если заданная форма не null, и любое из вышеперечисленных условий не выполняется, форма этого окна не изменится, и будет выброшено исключение UnsupportedOperationException или IllegalComponentStateException.

Уровни прозрачности отдельных пикселей также могут зависеть от альфа-компонента их цвета (см. setBackground(Color)) и значения непрозрачности (см. setOpacity(float)). Подробнее см. GraphicsDevice.WindowTranslucency.

public Color getBackground()

Получает цвет фона этого окна.

Обратите внимание, что альфа-компонент возвращаемого цвета указывает, находится ли окно в режиме непрозрачности (прозрачности на пиксель).

public void setBackground(Color bgColor)

Устанавливает цвет фона этого окна.

Если система окон поддерживает PERPIXEL_TRANSLUCENT прозрачность, альфа-компонент заданного цвета фона может повлиять на режим работы этого окна: он указывает, должно ли это окно быть непрозрачным (альфа равна 1.0f) или полупрозрачным на уровне пикселей (альфа меньше 1.0f). Если заданный цвет фона — null, окно считается полностью непрозрачным.

Для включения режима полупрозрачности на уровне пикселей для этого окна должны быть выполнены следующие условия:

• Прозрачность PERPIXEL_TRANSLUCENT должна поддерживаться графическим устройством, на котором расположено это окно.
• Окно должно быть без декораций (см. Frame.setUndecorated(boolean) и Dialog.setUndecorated(boolean))
• Окно не должно быть в полноэкранном режиме (см. GraphicsDevice.setFullScreenWindow(Window))

Если альфа-компонент запрошенного цвета фона меньше 1.0f, и любое из вышеперечисленных условий не выполнено, цвет фона этого окна не изменится, альфа-компонент заданного цвета фона не повлияет на режим работы окна, и будет брошено исключение UnsupportedOperationException или IllegalComponentStateException.

Когда окно полупрозрачно на уровне пикселей, подсистема отрисовки учитывает значение альфа-канала каждого пикселя. Если пиксель окрашивается с альфа-каналом, равным нулю, он становится визуально прозрачным. Если альфа-канал пикселя равен 1.0f, пиксель полностью непрозрачен. Промежуточные значения альфа-канала делают пиксель полупрозрачным. В этом режиме фон окна отрисовывается с использованием значения альфа-канала заданного цвета фона. Если значение альфа-канала аргумента этого метода равно 0, фон не отрисовывается вообще.

Фактический уровень прозрачности заданного пикселя также зависит от непрозрачности окна (см. setOpacity(float)), а также текущей формы этого окна (см. setShape(Shape)).

Обратите внимание, что отрисовка пикселя с альфа-каналом 0 может или не может отключить обработку событий мыши для этого пикселя. Это поведение зависит от платформы. Чтобы убедиться, что события мыши не отправляются на конкретный пиксель, этот пиксель должен быть исключен из формы окна.

Включение режима полупрозрачности на уровне пикселей может изменить конфигурацию графики этого окна из-за требований родной платформы.

public boolean isOpaque()

Указывает, является ли окно в данный момент непрозрачным.

Метод возвращает false, если цвет фона окна не null, а альфа-компонент цвета меньше 1.0f. В противном случае метод возвращает true.

public void paint(Graphics g)

Отрисовывает контейнер. Этот метод перенаправляет отрисовку легким компонентам, которые являются дочерними элементами этого контейнера. Если этот метод переопределен, super.paint(g) должен вызываться для корректной отрисовки легких компонентов. Если дочерний компонент полностью зажат текущими настройками обрезки в g, paint() не будет перенаправлен на этот компонент.