Класс Window

public Window(Frame owner)

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

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

public Window(Window owner)

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

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

public Window(Window owner, GraphicsConfiguration gc)

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

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

public List<Image> getIconImages()

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

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

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

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

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

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

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

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

public void setIconImage(Image image)

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

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

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

     setIconImage(image);
 

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

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

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

public void addNotify()

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

public void pack()

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

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

public void setMinimumSize(Dimension minimumSize)

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

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

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

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

public void setSize(Dimension d)

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

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

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

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

public void setSize(int width, int height)

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

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

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

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

public void setLocation(int x, int y)

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

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

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

public void setLocation(Point p)

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

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

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

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

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

public void setVisible(boolean b)

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

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

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

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

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

@Deprecated public void show()

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

@Deprecated public void hide()

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

public void dispose()

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

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

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

public void toFront()

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

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

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

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

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

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

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

public void toBack()

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

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

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

public Toolkit getToolkit()

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

public final String getWarningString()

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

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

public Locale getLocale()

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

public InputContext getInputContext()

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

public void setCursor(Cursor cursor)

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

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

public Window getOwner()

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

public Window[] getOwnedWindows()

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

public static Window[] getWindows()

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

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

public static Window[] getOwnerlessWindows()

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

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

public void setModalExclusionType(Dialog.ModalExclusionType exclusionType)

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

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

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

public Dialog.ModalExclusionType getModalExclusionType()

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

public void addWindowListener(WindowListener l)

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

Обратитесь к Вопросы многопоточности AWT для получения подробностей о модели многопоточности 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()

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

public Component getMostRecentFocusOwner()

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

public boolean isActive()

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

public boolean isFocused()

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

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

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

public final void setFocusCycleRoot(boolean focusCycleRoot)

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

public final boolean isFocusCycleRoot()

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

public final Container getFocusCycleRootAncestor()

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

public final boolean isFocusableWindow()

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

public boolean getFocusableWindowState()

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

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

public void setFocusableWindowState(boolean focusableWindowState)

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

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

public void setAutoRequestFocus(boolean autoRequestFocus)

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

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

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

public boolean isAutoRequestFocus()

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

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

public void addPropertyChangeListener(PropertyChangeListener listener)

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

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

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

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

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

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

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

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

public boolean isValidateRoot()

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

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

@Deprecated public boolean postEvent(Event e)

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

public boolean isShowing()

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

public void setType(Window.Type type)

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

public Window.Type getType()

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

public AccessibleContext getAccessibleContext()

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

public void setLocationRelativeTo(Component c)

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

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

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

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

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

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

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

public void createBufferStrategy(int numBuffers)

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

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

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

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

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

public BufferStrategy getBufferStrategy()

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

public void setLocationByPlatform(boolean locationByPlatform)

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