Класс Window

public Window(Frame owner)

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

public Window(Window owner)

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

public Window(Window owner, GraphicsConfiguration gc)

Создает новое, изначально невидимое окно с указанным владельцем Window и GraphicsConfiguration экранного устройства. Окно не сможет получать фокус, пока ближайший владелец — Frame или 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().
• Свойство autoRequestFocus объекта 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), виртуальная машина может завершить работу. Дополнительные сведения см. в разделе Проблемы многопоточности AWT.

public void toFront()

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

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

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

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

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

Если этот метод устанавливает фокус на это окно, и оно является Frame или Dialog, оно также становится активным. Если это окно имеет фокус, но не является Frame или Dialog, активным становится первое окно Frame или Dialog, которому принадлежит это окно.

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

public void toBack()

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

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

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

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

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

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

public static Window[] getOwnerlessWindows()

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

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

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)

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

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

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

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

protected void processEvent(AWTEvent e)

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

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

protected void processWindowEvent(WindowEvent e)

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

• Зарегистрирован объект WindowListener с помощью addWindowListener
• События окна включены с помощью enableEvents

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

protected void processWindowFocusEvent(WindowEvent e)

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

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

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

protected void processWindowStateEvent(WindowEvent e)

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

• Зарегистрирован WindowStateListener с помощью addWindowStateListener
• События состояния окна включены с помощью enableEvents

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

public final void setAlwaysOnTop(boolean alwaysOnTop)

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

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

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

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

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

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

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

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

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

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

public final void setFocusCycleRoot(boolean focusCycleRoot)

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

public final boolean isFocusCycleRoot()

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

public final Container getFocusCycleRootAncestor()

Всегда возвращает null, поскольку у окон нет предков: они представляют верхний уровень иерархии Component.

public final boolean isFocusableWindow()

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

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

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

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

Возвращает BufferStrategy, используемую этим компонентом. Этот метод возвращает null, если BufferStrategy еще не создана или уже освобождена.

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

Чтобы задать ненулевую форму, должны выполняться следующие условия:

• Система должна поддерживать полупрозрачность 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() этому дочернему компоненту передаваться не будет.