Класс Window

public Window(Frame owner)

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

public Window(Window owner)

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

public Window(Window owner, GraphicsConfiguration gc)

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

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 окна имеет значение 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()

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

@Deprecated(since="24", forRemoval=true) public final String getWarningString()

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

Строки предупреждений больше не применимы, поэтому этот метод всегда возвращает null и может быть удален в будущей версии.

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 для получения подробностей о модели потоков AWT.

public void addWindowStateListener(WindowStateListener l)

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

См. Вопросы потоков AWT для получения подробностей о модели потоков AWT.

public void addWindowFocusListener(WindowFocusListener l)

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

См. Вопросы потоков AWT для получения подробностей о модели потоков AWT.

public void removeWindowListener(WindowListener l)

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

См. Вопросы потоков AWT для получения подробностей о модели потоков AWT.

public void removeWindowStateListener(WindowStateListener l)

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

См. Вопросы потоков AWT для получения подробностей о модели потоков AWT.

public void removeWindowFocusListener(WindowFocusListener l)

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

См. Вопросы потоков AWT для получения подробностей о модели потоков 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)

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

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

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

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

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

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

public boolean isAlwaysOnTopSupported()

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

public final boolean isAlwaysOnTop()

Возвращает, является ли это окно окном always-on-top.

public Component getFocusOwner()

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

public Component getMostRecentFocusOwner()

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

public boolean isActive()

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

public boolean isFocused()

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

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

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

Возвращает клавишу перемещения фокуса для этого окна. (См. setFocusTraversalKeys для полного описания каждой клавиши.)

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

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)

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

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

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

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

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

public BufferStrategy getBufferStrategy()

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

public void setLocationByPlatform(boolean locationByPlatform)

Устанавливает, должно ли это окно появляться в стандартном месте для системного окна или в текущем месте (возвращённом методом 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, этот метод восстанавливает форму по умолчанию, делая окно прямоугольным на большинстве платформ.

Для установки формы, отличной от 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() не будет пересылаться этому дочернему элементу.