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

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

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

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

Получает строку предупреждения, которая отображается с этим окном.

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

public Locale getLocale()

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

public InputContext getInputContext()

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

public void setCursor(Cursor cursor)

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

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

public Window getOwner()

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

public Window[] getOwnedWindows()

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

public static Window[] getWindows()

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

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

public static Window[] getOwnerlessWindows()

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

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

public void setModalExclusionType(Dialog.ModalExclusionType exclusionType)

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

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

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

public Dialog.ModalExclusionType getModalExclusionType()

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

public void addWindowListener(WindowListener l)

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

Подробные сведения о потоковой модели AWT см. в разделе Вопросы многопоточности в AWT.

public void addWindowStateListener(WindowStateListener l)

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

Подробные сведения о потоковой модели AWT см. в разделе Вопросы многопоточности в AWT.

public void addWindowFocusListener(WindowFocusListener l)

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

Подробные сведения о потоковой модели AWT см. в разделе Вопросы многопоточности в AWT.

public void removeWindowListener(WindowListener l)

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

Подробные сведения о потоковой модели AWT см. в разделе Вопросы многопоточности в AWT.

public void removeWindowStateListener(WindowStateListener l)

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

Подробные сведения о потоковой модели AWT см. в разделе Вопросы многопоточности в AWT.

public void removeWindowFocusListener(WindowFocusListener l)

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

Подробные сведения о потоковой модели AWT см. в разделе Вопросы многопоточности в AWT.

public WindowListener[] getWindowListeners()

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

public WindowFocusListener[] getWindowFocusListeners()

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

public WindowStateListener[] getWindowStateListeners()

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

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

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

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

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

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

protected void processEvent(AWTEvent e)

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

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

protected void processWindowEvent(WindowEvent e)

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

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

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

protected void processWindowFocusEvent(WindowEvent e)

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

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

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

protected void processWindowStateEvent(WindowEvent e)

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

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

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

public final void setAlwaysOnTop(boolean alwaysOnTop)

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

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

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

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

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

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

public boolean isAlwaysOnTopSupported()

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

public final boolean isAlwaysOnTop()

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

public Component getFocusOwner()

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

public Component getMostRecentFocusOwner()

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

public boolean isActive()

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

public boolean isFocused()

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

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

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

public final void setFocusCycleRoot(boolean focusCycleRoot)

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

public final boolean isFocusCycleRoot()

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

public final Container getFocusCycleRootAncestor()

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

public final boolean isFocusableWindow()

Возвращает значение, указывающее, может ли это окно стать сфокусированным окном, то есть могут ли это окно или любой из его подкомпонентов стать владельцем фокуса. Чтобы Frame или Dialog могли получать фокус, их состояние доступности фокуса окна (focusable Window state) должно быть установлено в true. Чтобы окно, не являющееся Frame или Dialog, могло получать фокус, его состояние доступности фокуса окна должно быть установлено в 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 в список слушателей. Слушатель регистрируется для всех связанных свойств (bound properties) этого класса, включая следующие:

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

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

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

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

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

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

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

public boolean isValidateRoot()

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

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

@Deprecated public boolean postEvent(Event e)

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

public boolean isShowing()

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

public void setType(Window.Type type)

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

public Window.Type getType()

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

public AccessibleContext getAccessibleContext()

Возвращает объект AccessibleContext, связанный с этим Window. Для окон 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 с этим количеством буферов. Сначала предпринимается попытка использовать стратегию переключения страниц (page-flipping), затем стратегию блиттинга (blitting) с использованием ускоренных буферов. Наконец, используется стратегия неускоренного блиттинга.

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

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

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