Класс 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 сканируется на изображения наиболее подходящих размеров с начала. Если список содержит несколько изображений одного размера, используется первое.

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

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.

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

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

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

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

@Deprecated
public void show()

@Deprecated
public void hide()

public void dispose()

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

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

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

public void toFront()

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

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

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

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

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

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

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

public void toBack()

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

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

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

public Toolkit getToolkit()

public final String getWarningString()

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

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

public Locale getLocale()

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)
                          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()

public Component getMostRecentFocusOwner()

public boolean isActive()

public boolean isFocused()

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

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

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

public final void setFocusCycleRoot(boolean focusCycleRoot)

public final boolean isFocusCycleRoot()

public final Container getFocusCycleRootAncestor()

public final boolean isFocusableWindow()

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")
• набор клавиш FORWARD_TRAVERSAL_KEYS этого окна ("forwardFocusTraversalKeys")
• набор клавиш BACKWARD_TRAVERSAL_KEYS этого окна ("backwardFocusTraversalKeys")
• набор клавиш UP_CYCLE_TRAVERSAL_KEYS этого окна ("upCycleFocusTraversalKeys")
• набор клавиш DOWN_CYCLE_TRAVERSAL_KEYS этого окна ("downCycleFocusTraversalKeys")
• политика перехода фокуса этого окна ("focusTraversalPolicy")
• состояние фокусируемого окна этого окна ("focusableWindowState")
• состояние "всегда сверху" этого окна ("alwaysOnTop")

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

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

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)

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

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

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

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

public boolean isValidateRoot()

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

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

@Deprecated
public boolean postEvent(Event e)

public boolean isShowing()

@Deprecated
public void applyResourceBundle(ResourceBundle rb)

@Deprecated
public void applyResourceBundle(String rbName)

public void setType(Window.Type type)

public Window.Type getType()

public AccessibleContext getAccessibleContext()

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()

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()

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()

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, фон не отрисовывается.

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

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

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

public boolean isOpaque()

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

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

public void paint(Graphics g)