Класс Container

java.lang.Object
- java.awt.Component
- - java.awt.Container

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable

Непосредственные известные подклассы:: BasicSplitPaneDivider, CellRendererPane, DefaultTreeCellEditor.EditorContainer, JComponent, Panel, ScrollPane, Window

public class Container
extends Component

Объект контейнера Abstract Window Toolkit (AWT) — это компонент, который может содержать другие компоненты AWT.

Компоненты, добавленные в контейнер, отслеживаются в списке. Порядок списка определяет порядок стекирования компонентов в контейнере спереди назад. Если при добавлении компонента в контейнер индекс не указан, он будет добавлен в конец списка (и, следовательно, в нижнюю часть порядка стекирования).

Примечание: Подробную информацию о подсистеме фокусировки см. в Руководстве по подсистеме фокусировки в Java Tutorial и Спецификации фокуса.

С тех пор:: JDK1.0
См. также:: add(java.awt.Component, int), getComponent(int), LayoutManager, Сериализованная форма

Вложенные классы

Модификатор и тип	Класс и описание
`protected class`	`Container.AccessibleAWTContainer` Внутренний класс контейнера, обеспечивающий поддержку доступности по умолчанию.

Вложенные классы/интерфейсы, унаследованные от класса java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Сводка полей

Поля, унаследованные от класса java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, унаследованные от интерфейса java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Сводка конструкторов

Конструктор и описание
`Container()` Создаёт новый контейнер.

Сводка методов

Модификатор и тип	Метод и описание
`Component`	`add(Component comp)` Добавляет указанный компонент в конец этого контейнера.
`Component`	`add(Component comp, int index)` Добавляет указанный компонент в этот контейнер в заданной позиции.
`void`	`add(Component comp, Object constraints)` Добавляет указанный компонент в конец этого контейнера.
`void`	`add(Component comp, Object constraints, int index)` Добавляет указанный компонент в этот контейнер с указанными ограничениями в указанный индекс.
`Component`	`add(String name, Component comp)` Добавляет указанный компонент в этот контейнер.
`void`	`addContainerListener(ContainerListener l)` Добавляет указанного слушателя контейнера для получения событий контейнера из этого контейнера.
`protected void`	`addImpl(Component comp, Object constraints, int index)` Добавляет указанный компонент в этот контейнер в указанный индекс.
`void`	`addNotify()` Делает этот контейнер отображаемым, подключив его к ресурсу нативного экрана.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` Добавляет PropertyChangeListener в список слушателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)` Добавляет PropertyChangeListener в список слушателей для определенного свойства.
`void`	`applyComponentOrientation(ComponentOrientation o)` Устанавливает свойство `ComponentOrientation` этого контейнера и всех компонентов, содержащихся в нем.
`boolean`	`areFocusTraversalKeysSet(int id)` Возвращает, определён ли набор клавиш перехода фокуса для данной операции перехода фокуса для этого контейнера.
`int`	`countComponents()` Устарело. С версии JDK 1.1 заменено на getComponentCount().
`void`	`deliverEvent(Event e)` Устарело. С версии JDK 1.1 заменено на `dispatchEvent(AWTEvent e)`
`void`	`doLayout()` Заставляет этот контейнер расположить свои компоненты.
`Component`	`findComponentAt(int x, int y)` Находит видимый дочерний компонент, содержащий указанную позицию.
`Component`	`findComponentAt(Point p)` Находит видимый дочерний компонент, содержащий указанную точку.
`float`	`getAlignmentX()` Возвращает выравнивание по оси X.
`float`	`getAlignmentY()` Возвращает выравнивание по оси Y.
`Component`	`getComponent(int n)` Получает n-ый компонент в этом контейнере.
`Component`	`getComponentAt(int x, int y)` Находит компонент, содержащий позицию x,y.
`Component`	`getComponentAt(Point p)` Получает компонент, содержащий указанную точку.
`int`	`getComponentCount()` Получает количество компонентов в этой панели.
`Component[]`	`getComponents()` Получает все компоненты в этом контейнере.
`int`	`getComponentZOrder(Component comp)` Возвращает индекс z-порядка компонента внутри контейнера.
`ContainerListener[]`	`getContainerListeners()` Возвращает массив всех слушателей контейнера, зарегистрированных в этом контейнере.
`Set<AWTKeyStroke>`	`getFocusTraversalKeys(int id)` Возвращает набор клавиш перехода фокуса для данной операции перехода для этого контейнера.
`FocusTraversalPolicy`	`getFocusTraversalPolicy()` Возвращает политику перехода фокуса, которая будет управлять перемещением клавиатуры по дочерним элементам этого контейнера, или null, если этот контейнер не является корнем цикла фокуса.
`Insets`	`getInsets()` Определяет отступы этого контейнера, которые указывают размер границы контейнера.
`LayoutManager`	`getLayout()` Получает менеджер компоновки для этого контейнера.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)` Возвращает массив всех объектов, в настоящее время зарегистрированных в качестве `FooListener` в этом `Container`.
`Dimension`	`getMaximumSize()` Возвращает максимальный размер этого контейнера.
`Dimension`	`getMinimumSize()` Возвращает минимальный размер этого контейнера.
`Point`	`getMousePosition(boolean allowChildren)` Возвращает позицию указателя мыши в пространстве координат этого `Container`, если `Container` находится под указателем мыши, в противном случае возвращает `null`.
`Dimension`	`getPreferredSize()` Возвращает предпочтительный размер этого контейнера.
`Insets`	`insets()` Устарело. С версии JDK 1.1 заменено на `getInsets()`.
`void`	`invalidate()` Перерисовывает контейнер.
`boolean`	`isAncestorOf(Component c)` Проверяет, содержится ли компонент в иерархии компонентов этого контейнера.
`boolean`	`isFocusCycleRoot()` Возвращает, является ли этот контейнер корнем цикла перехода фокуса.
`boolean`	`isFocusCycleRoot(Container container)` Возвращает, является ли указанный контейнер корнем цикла перехода фокуса цикла перехода фокуса этого контейнера.
`boolean`	`isFocusTraversalPolicyProvider()` Возвращает, предоставляет ли этот контейнер политику перехода фокуса.
`boolean`	`isFocusTraversalPolicySet()` Возвращает, была ли явно установлена политика перехода фокуса для этого контейнера.
`boolean`	`isValidateRoot()` Указывает, является ли этот контейнер корнем валидации.
`void`	`layout()` Устарело. С версии JDK 1.1 заменено на `doLayout()`.
`void`	`list(PrintStream out, int indent)` Выводит список этого контейнера в указанный поток вывода.
`void`	`list(PrintWriter out, int indent)` Выводит список, начиная с указанного отступа, в указанный объект PrintWriter.
`Component`	`locate(int x, int y)` Устарело. С версии JDK 1.1 заменено на `getComponentAt(int, int)`.
`Dimension`	`minimumSize()` Устарело. С версии JDK 1.1 заменено на `getMinimumSize()`.
`void`	`paint(Graphics g)` Отрисовывает контейнер.
`void`	`paintComponents(Graphics g)` Отрисовывает каждый из компонентов в этом контейнере.
`protected String`	`paramString()` Возвращает строку, представляющую состояние этого `Container`.
`Dimension`	`preferredSize()` Устарело. С версии JDK 1.1 заменено на `getPreferredSize()`.
`void`	`print(Graphics g)` Выводит контейнер.
`void`	`printComponents(Graphics g)` Выводит каждый из компонентов в этом контейнере.
`protected void`	`processContainerEvent(ContainerEvent e)` Обрабатывает события контейнера, возникающие в этом контейнере, пересылая их всем зарегистрированным объектам ContainerListener.
`protected void`	`processEvent(AWTEvent e)` Обрабатывает события в этом контейнере.
`void`	`remove(Component comp)` Удаляет указанный компонент из этого контейнера.
`void`	`remove(int index)` Удаляет компонент, указанный `index`, из этого контейнера.
`void`	`removeAll()` Удаляет все компоненты из этого контейнера.
`void`	`removeContainerListener(ContainerListener l)` Удаляет указанного слушателя контейнера, чтобы он больше не получал события контейнера от этого контейнера.
`void`	`removeNotify()` Делает этот контейнер неотображаемым, удалив его подключение к ресурсу нативного экрана.
`void`	`setComponentZOrder(Component comp, int index)` Перемещает указанный компонент в указанный индекс z-порядка в контейнере.
`void`	`setFocusCycleRoot(boolean focusCycleRoot)` Устанавливает, является ли этот контейнер корнем цикла перехода фокуса.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)` Устанавливает набор клавиш перехода фокуса для данной операции перехода для этого контейнера.
`void`	`setFocusTraversalPolicy(FocusTraversalPolicy policy)` Устанавливает политику перехода фокуса, которая будет управлять перемещением клавиатуры по дочерним элементам этого контейнера, если этот контейнер является корнем цикла фокуса.
`void`	`setFocusTraversalPolicyProvider(boolean provider)` Устанавливает, будет ли этот контейнер использоваться для предоставления политики перехода фокуса.
`void`	`setFont(Font f)` Устанавливает шрифт этого контейнера.

`void`	`setLayout(LayoutManager mgr)` Устанавливает менеджер компоновки для этого контейнера.
`void`	`transferFocusDownCycle()` Переносит фокус на следующий элемент в цикле перехода фокуса.
`void`	`update(Graphics g)` Обновляет контейнер.
`void`	`validate()` Проверяет этот контейнер и все его подкомпоненты.
`protected void`	`validateTree()` Рекурсивно спускается по дереву контейнеров и пересчитывает компоновку для всех поддеревьев, помеченных как требующие пересчета (помеченных как недействительные).

Методы, унаследованные от класса java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Краткое описание конструкторов

Container

public Container()

Создает новый Container. Контейнеры могут быть расширены напрямую, но в этом случае они являются легковесными и должны содержаться родительским элементом где-то выше в дереве компонентов, который является нативным (например, Frame).

Краткое описание методов

getComponentCount

public int getComponentCount()

Возвращает количество компонентов в этой панели.

Примечание: этот метод должен вызываться под блокировкой дерева AWT.

Возвращает:: количество компонентов в этой панели.
С версии:: JDK1.1
См. также:: getComponent(int), Component.getTreeLock()

countComponents

@Deprecated
public int countComponents()

Устарело. Начиная с версии JDK 1.1, заменено на getComponentCount().

getComponent

public Component getComponent(int n)

Возвращает n-ый компонент в этом контейнере.

Примечание: этот метод должен вызываться под блокировкой дерева AWT.

Параметры:: n - индекс компонента, который нужно получить.
Возвращает:: n^ый компонент в этом контейнере.
Исключения:: ArrayIndexOutOfBoundsException - если n^ое значение не существует.
См. также:: Component.getTreeLock()

getComponents

public Component[] getComponents()

Возвращает все компоненты в этом контейнере.

Примечание: этот метод должен вызываться под блокировкой дерева AWT.

Возвращает:: массив всех компонентов в этом контейнере.
См. также:: Component.getTreeLock()

getInsets

public Insets getInsets()

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

Объект Frame, например, имеет верхний отступ, соответствующий высоте строки заголовка фрейма.

Возвращает:: отступы этого контейнера.
С версии:: JDK1.1
См. также:: Insets, LayoutManager

insets

@Deprecated
public Insets insets()

Устарело. Начиная с версии JDK 1.1, заменено на getInsets().

add

public Component add(Component comp)

Добавляет указанный компонент в конец этого контейнера. Это вспомогательный метод для addImpl(java.awt.Component, java.lang.Object, int).

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

Параметры:: comp - компонент, который нужно добавить
Возвращает:: аргумент компонента
Исключения:: NullPointerException - если comp является null
См. также:: addImpl(java.awt.Component, java.lang.Object, int), invalidate(), validate(), JComponent.revalidate()

add

public Component add(String name,
                     Component comp)

Добавляет указанный компонент в этот контейнер. Это вспомогательный метод для addImpl(java.awt.Component, java.lang.Object, int).

Этот метод устарел, начиная с версии 1.1. Пожалуйста, используйте метод add(Component, Object) вместо этого.

Исключения:: NullPointerException - если comp является null
См. также:: add(Component, Object), invalidate()

add

public Component add(Component comp,
                     int index)

Добавляет указанный компонент в этот контейнер в заданную позицию. Это вспомогательный метод для addImpl(java.awt.Component, java.lang.Object, int).

Параметры:: comp - компонент, который нужно добавить; index - позиция, в которую нужно вставить компонент, или -1 для добавления компонента в конец
Возвращает:: компонент comp
Исключения:: NullPointerException - если comp является null; IllegalArgumentException - если index недействителен (см. addImpl(java.awt.Component, java.lang.Object, int) для подробностей)
См. также:: addImpl(java.awt.Component, java.lang.Object, int), remove(int), invalidate(), validate(), JComponent.revalidate()

setComponentZOrder

public void setComponentZOrder(Component comp,
                               int index)

Перемещает указанный компонент в указанный индекс z-порядка в контейнере. Z-порядок определяет порядок, в котором компоненты рисуются; компонент с самым высоким z-порядком рисуется первым, а компонент с самым низким z-порядком рисуется последним. Там, где компоненты перекрываются, компонент с более низким z-порядком рисуется поверх компонента с более высоким z-порядком.

Если компонент является дочерним элементом какого-либо другого контейнера, он удаляется из этого контейнера перед добавлением в этот контейнер. Важное различие между этим методом и java.awt.Container.add(Component, int) заключается в том, что этот метод не вызывает removeNotify для компонента при его удалении из предыдущего контейнера, если это не обязательно и если это разрешено базовой системой нативного оконного интерфейса. Таким образом, если компонент имеет фокус клавиатуры, он сохраняет фокус при перемещении в новое положение.

Гарантируется, что это свойство применяется только к легковесным не-Container компонентам.

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

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

Параметры:: comp - компонент, который нужно переместить; index - позиция в списке контейнера для вставки компонента, где getComponentCount() добавляет в конец
Исключения:: NullPointerException - если comp является null; IllegalArgumentException - если comp является одним из родительских элементов контейнера; IllegalArgumentException - если index не находится в диапазоне [0, getComponentCount()] для перемещения между контейнерами или не находится в диапазоне [0, getComponentCount()-1] для перемещения внутри контейнера; IllegalArgumentException - при добавлении контейнера в самого себя; IllegalArgumentException - при добавлении Window в контейнер
С версии:: 1.5
См. также:: getComponentZOrder(java.awt.Component), invalidate()

getComponentZOrder

public int getComponentZOrder(Component comp)

Возвращает индекс z-порядка компонента внутри контейнера. Чем выше компонент в иерархии z-порядка, тем ниже его индекс. Компонент с самым низким индексом z-порядка рисуется последним, поверх всех других дочерних компонентов.

Параметры:: comp - запрашиваемый компонент
Возвращает:: индекс z-порядка компонента; в противном случае возвращает -1, если компонент null или не принадлежит контейнеру
С версии:: 1.5
См. также:: setComponentZOrder(java.awt.Component, int)

add

public void add(Component comp,
                Object constraints)

Добавляет указанный компонент в конец этого контейнера. Также уведомляет менеджер макета о добавлении компонента в макет этого контейнера с использованием указанного объекта ограничений. Это вспомогательный метод для addImpl(java.awt.Component, java.lang.Object, int).

Параметры:: comp - компонент, который нужно добавить; constraints - объект, выражающий ограничения макета для этого компонента
Исключения:: NullPointerException - если comp является null
С версии:: JDK1.1
См. также:: addImpl(java.awt.Component, java.lang.Object, int), invalidate(), validate(), JComponent.revalidate(), LayoutManager

add

public void add(Component comp,
                Object constraints,
                int index)

Добавляет указанный компонент в этот контейнер с указанными ограничениями в указанный индекс. Также уведомляет менеджер макета о добавлении компонента в макет этого контейнера с использованием указанного объекта ограничений. Это вспомогательный метод для addImpl(java.awt.Component, java.lang.Object, int).

Параметры:: comp - компонент, который нужно добавить; constraints - объект, выражающий ограничения компоновки для этого компонента; index - позиция в списке контейнера, в которую следует вставить компонент; -1 означает вставку в конец компонента
Исключения:: NullPointerException - если comp является null; IllegalArgumentException - если index является недопустимым (см. addImpl(java.awt.Component, java.lang.Object, int) для подробностей)
См. также:: addImpl(java.awt.Component, java.lang.Object, int), invalidate(), validate(), JComponent.revalidate(), remove(int), LayoutManager

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

Добавляет указанный компонент в этот контейнер в указанный индекс. Этот метод также уведомляет менеджер компоновки о добавлении компонента в компоновку этого контейнера с использованием указанного объекта ограничений через метод addLayoutComponent.

Ограничения определяются используемым менеджером компоновки. Например, класс BorderLayout определяет пять ограничений: BorderLayout.NORTH, BorderLayout.SOUTH, BorderLayout.EAST, BorderLayout.WEST, и BorderLayout.CENTER.

Класс GridBagLayout требует объект типа GridBagConstraints. Отсутствие правильного типа объекта ограничений приводит к исключению IllegalArgumentException.

Если текущий менеджер компоновки реализует интерфейс LayoutManager2, то вызывается метод LayoutManager2.addLayoutComponent(Component,Object). Если текущий менеджер компоновки не реализует интерфейс LayoutManager2, а constraints является объектом типа String, то вызывается метод LayoutManager.addLayoutComponent(String,Component).

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

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

super.addImpl(comp, constraints, index)

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

Параметры:: comp - компонент, который нужно добавить; constraints - объект, выражающий ограничения компоновки для этого компонента; index - позиция в списке контейнера, в которую следует вставить компонент; -1 означает добавление в конец
Исключения:: IllegalArgumentException - если index является недопустимым; если comp является дочерним компонентом этого контейнера, допустимый диапазон составляет [-1, getComponentCount()-1]; если компонент не является дочерним компонентом этого контейнера, допустимый диапазон составляет [-1, getComponentCount()]; IllegalArgumentException - если comp является предком этого контейнера; IllegalArgumentException - если добавляется окно в контейнер; NullPointerException - если comp является null
С момента:: JDK1.1
См. также:: add(Component), add(Component, int), add(Component, java.lang.Object), invalidate(), LayoutManager, LayoutManager2

remove

public void remove(int index)

Удаляет компонент, указанный в index, из этого контейнера. Этот метод также уведомляет менеджер компоновки об удалении компонента из компоновки этого контейнера через метод removeLayoutComponent.

Параметры:: index - индекс компонента, который нужно удалить
Исключения:: ArrayIndexOutOfBoundsException - если index не находится в диапазоне [0, getComponentCount()-1]
С момента:: JDK1.1
См. также:: add(java.awt.Component), invalidate(), validate(), getComponentCount()

remove

public void remove(Component comp)

Удаляет указанный компонент из этого контейнера. Этот метод также уведомляет менеджер компоновки об удалении компонента из компоновки этого контейнера через метод removeLayoutComponent.

Параметры:: comp - компонент, который нужно удалить
Исключения:: NullPointerException - если comp является null
См. также:: add(java.awt.Component), invalidate(), validate(), remove(int)

removeAll

public void removeAll()

Удаляет все компоненты из этого контейнера. Этот метод также уведомляет менеджер компоновки об удалении компонентов из компоновки этого контейнера через метод removeLayoutComponent.

См. также:: add(java.awt.Component), remove(int), invalidate()

getLayout

public LayoutManager getLayout()

Получает менеджер компоновки для этого контейнера.

См. также:: doLayout(), setLayout(java.awt.LayoutManager)

setLayout

public void setLayout(LayoutManager mgr)

Устанавливает менеджер компоновки для этого контейнера.

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

Параметры:: mgr - указанный менеджер компоновки
См. также:: doLayout(), getLayout(), invalidate()

doLayout

public void doLayout()

Вызывает компоновку компонентов в этом контейнере. Большинство программ не должны вызывать этот метод напрямую, а должны вызывать метод validate вместо этого.

Переопределяет:: doLayout в классе Component
С момента:: JDK1.1
См. также:: LayoutManager.layoutContainer(java.awt.Container), setLayout(java.awt.LayoutManager), validate()

layout

@Deprecated
public void layout()

Устаревший. Начиная с версии JDK 1.1, заменён на doLayout().

Переопределяет:: layout в классе Component

isValidateRoot

public boolean isValidateRoot()

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

Изменения, связанные с компоновкой, такие как границы дочерних элементов корня валидации, не влияют на компоновку родителя корня валидации. Эта особенность позволяет методу invalidate() останавливать недействительность иерархии компонентов при обнаружении корня валидации. Однако, чтобы сохранить обратную совместимость, это новое оптимизированное поведение включено только при значении системной переменной java.awt.smartInvalidate установленной в true.

Если иерархия компонентов содержит корни валидации и новое оптимизированное поведение invalidate() включено, метод validate() должен быть вызван на корне валидации ранее недействительного компонента для восстановления валидности иерархии позднее. В противном случае вызов метода validate() на верхнем контейнере (например, объект Frame) должен использоваться для восстановления валидности иерархии компонентов.

Классы Window и Applet являются корнями валидации в AWT. Swing вводит больше корней валидации.

Возвращает:: является ли этот контейнер корнем валидации
С момента:: 1.7
См. также:: invalidate(), Component.invalidate(), JComponent.isValidateRoot(), JComponent.revalidate()

invalidate

public void invalidate()

Делает контейнер недействительным.

Если менеджер компоновки LayoutManager, установленный на этот контейнер, является экземпляром интерфейса LayoutManager2, то вызывается метод LayoutManager2.invalidateLayout(Container) с этим контейнером Container в качестве аргумента.

После этого метод помечает этот контейнер как недействительный и делает недействительными его предков. Подробнее см. метод Component.invalidate().

Переопределяет:: invalidate в классе Component
См. также:: validate(), layout(), LayoutManager2

validate

public void validate()

Проверяет этот контейнер и все его подкомпоненты.

Проверка контейнера означает размещение его подкомпонентов. Изменения, связанные с размещением, такие как установка границ компонента или добавление компонента в контейнер, автоматически делают контейнер недействительным. Обратите внимание, что предки контейнера также могут быть объявлены недействительными (см. Component.invalidate() для получения подробностей.) Поэтому для восстановления действительности иерархии необходимо вызвать метод validate() на самом верхнем недействительном контейнере иерархии.

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

Если этот Container недействителен, этот метод вызывает метод validateTree и помечает этот Container как действительный. В противном случае никаких действий не выполняется.

Переопределяет:: validate в классе Component
См. также:: add(java.awt.Component), invalidate(), isValidateRoot(), JComponent.revalidate(), validateTree()

validateTree

protected void validateTree()

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

См. также:: doLayout(), validate()

setFont

public void setFont(Font f)

Устанавливает шрифт этого контейнера.

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

Переопределяет:: setFont в классе Component
Параметры:: f - Шрифт, который должен стать шрифтом этого контейнера.
С:: JDK1.0
См. также:: Component.getFont(), invalidate()

getPreferredSize

public Dimension getPreferredSize()

Возвращает предпочтительные размеры этого контейнера. Если предпочтительные размеры не были явно установлены методом Component.setPreferredSize(Dimension), и у этого Container есть non-null LayoutManager, то используется метод LayoutManager.preferredLayoutSize(Container) для расчета предпочтительных размеров.

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

Переопределяет:: getPreferredSize в классе Component
Возвращает:: экземпляр Dimension, представляющий предпочтительные размеры этого контейнера.
См. также:: getMinimumSize(), getMaximumSize(), getLayout(), LayoutManager.preferredLayoutSize(Container), Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize()

Устарело. С версии JDK 1.1 заменено на getPreferredSize().

Переопределяет:: preferredSize в классе Component

getMinimumSize

public Dimension getMinimumSize()

Возвращает минимальные размеры этого контейнера. Если минимальные размеры не были явно установлены методом Component.setMinimumSize(Dimension), и у этого Container есть non-null LayoutManager, то используется метод LayoutManager.minimumLayoutSize(Container) для расчета минимальных размеров.

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

Переопределяет:: getMinimumSize в классе Component
Возвращает:: экземпляр Dimension, представляющий минимальные размеры этого контейнера.
С:: JDK1.1
См. также:: getPreferredSize(), getMaximumSize(), getLayout(), LayoutManager.minimumLayoutSize(Container), Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize()

Устарело. С версии JDK 1.1 заменено на getMinimumSize().

Переопределяет:: minimumSize в классе Component

getMaximumSize

public Dimension getMaximumSize()

Возвращает максимальные размеры этого контейнера. Если максимальные размеры не были явно установлены методом Component.setMaximumSize(Dimension), и установленный на этом Container менеджер компоновки является экземпляром LayoutManager2, то используется метод LayoutManager2.maximumLayoutSize(Container) для расчета максимальных размеров.

Примечание: некоторые реализации могут кэшировать значение, возвращаемое методом LayoutManager2. Реализации, использующие кэширование, не обязаны вызывать maximumLayoutSize для LayoutManager2 каждый раз при вызове этого метода, а LayoutManager2 будет запрошен только после того, как Container станет недействительным.

Переопределяет:: getMaximumSize в классе Component
Возвращает:: экземпляр Dimension, представляющий максимальные размеры этого контейнера.
См. также:: getPreferredSize(), getMinimumSize(), getLayout(), LayoutManager2.maximumLayoutSize(Container), Component.getMaximumSize()

getAlignmentX

public float getAlignmentX()

Возвращает выравнивание по оси x. Это определяет, как компонент хочет быть выровнен относительно других компонентов. Значение должно быть числом от 0 до 1, где 0 соответствует выравниванию по началу, 1 – по окончанию, 0,5 – по центру и т. д.

Переопределяет:: getAlignmentX в классе Component

getAlignmentY

public float getAlignmentY()

Возвращает выравнивание по оси y. Это определяет, как компонент хочет быть выровнен относительно других компонентов. Значение должно быть числом от 0 до 1, где 0 соответствует выравниванию по началу, 1 – по окончанию, 0,5 – по центру и т. д.

Переопределяет:: getAlignmentY в классе Component

paint

public void paint(Graphics g)

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

Переопределяет:: paint в классе Component
Параметры:: g - указанное графическое окно
См. также:: Component.update(Graphics)

update

public void update(Graphics g)

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

Переопределяет:: update в классе Component
Параметры:: g - указанное графическое окно
См. также:: Component.update(Graphics)

print

public void print(Graphics g)

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

Переопределяет:: print в классе Component
Параметры:: g - указанное графическое окно
См. также:: Component.update(Graphics)

paintComponents

public void paintComponents(Graphics g)

Рисует каждый из компонентов в этом контейнере.

Параметры:: g - контекст графики.
См. также:: Component.paint(java.awt.Graphics), Component.paintAll(java.awt.Graphics)

printComponents

public void printComponents(Graphics g)

Печатает каждый из компонентов в этом контейнере.

Параметры:: g - контекст графики.
См. также:: Component.print(java.awt.Graphics), Component.printAll(java.awt.Graphics)

addContainerListener

public void addContainerListener(ContainerListener l)

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

Обратитесь к Проблемам потоков AWT для получения подробной информации о модели потоков AWT.

Параметры:: l - слушатель контейнера
См. также:: removeContainerListener(java.awt.event.ContainerListener), getContainerListeners()

removeContainerListener

public void removeContainerListener(ContainerListener l)

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

Обратитесь к Проблемам потоков AWT для получения подробной информации о модели потоков AWT.

Параметры:: l - слушатель контейнера
См. также:: addContainerListener(java.awt.event.ContainerListener), getContainerListeners()

getContainerListeners

public ContainerListener[] getContainerListeners()

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

Возвращает:: все слушатели этого контейнера или пустой массив, если слушатели контейнера не зарегистрированы
С:: 1.4
См. также:: addContainerListener(java.awt.event.ContainerListener), removeContainerListener(java.awt.event.ContainerListener)

getListeners

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

Возвращает массив всех объектов, в настоящее время зарегистрированных в качестве FooListener данного Container. FooListener регистрируются с помощью метода addFooListener.

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

ContainerListener[] cls = (ContainerListener[])(c.getListeners(ContainerListener.class));

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

Переопределяет:: getListeners в классе Component
Параметры:: listenerType - тип запрашиваемых слушателей; этот параметр должен указать интерфейс, который наследуется от java.util.EventListener
Возвращает:: массив всех объектов, зарегистрированных в качестве FooListener в этом контейнере, или пустой массив, если такие слушатели не были добавлены
Исключения:: ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener; NullPointerException - если listenerType является null
С:: 1.3
См. также:: getContainerListeners()

processEvent

protected void processEvent(AWTEvent e)

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

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

Переопределяет:: processEvent в классе Component
Параметры:: e - событие
См. также:: Component.processComponentEvent(java.awt.event.ComponentEvent), Component.processFocusEvent(java.awt.event.FocusEvent), Component.processKeyEvent(java.awt.event.KeyEvent), Component.processMouseEvent(java.awt.event.MouseEvent), Component.processMouseMotionEvent(java.awt.event.MouseEvent), Component.processInputMethodEvent(java.awt.event.InputMethodEvent), Component.processHierarchyEvent(java.awt.event.HierarchyEvent), Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)

processContainerEvent

protected void processContainerEvent(ContainerEvent e)

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

Объект ContainerListener зарегистрирован с помощью addContainerListener
События контейнера включены с помощью enableEvents

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

Параметры:: e - событие контейнера
См. также:: Component.enableEvents(long)

deliverEvent

@Deprecated
public void deliverEvent(Event e)

Устаревшее. Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent e)

Переопределяет:: deliverEvent в классе Component

getComponentAt

public Component getComponentAt(int x,
                                int y)

Определяет компонент, содержащий позицию x, y. Вернётся самый верхний дочерний компонент в случае перекрытия компонентов. Это определяется поиском компонента, ближайшего к индексу 0, который утверждает, что содержит заданную точку с помощью Component.contains(), за исключением того, что компоненты с нативными псевдонимами имеют приоритет над компонентами без них (т.е. лёгкие компоненты).

Переопределяет:: getComponentAt в классе Component
Параметры:: x - координата x; y - координата y
Возвращает:: null, если компонент не содержит позицию. Если в запрошенной точке нет дочернего компонента, а точка находится в границах контейнера, возвращается сам контейнер; в противном случае возвращается самый верхний дочерний компонент.
С:: JDK1.1
См. также:: Component.contains(int, int)

locate

@Deprecated
public Component locate(int x,
                                    int y)

Устаревшее. Начиная с версии JDK 1.1, заменено на getComponentAt(int, int).

Переопределяет:: locate в классе Component

getComponentAt

public Component getComponentAt(Point p)

Получает компонент, содержащий заданную точку.

Переопределяет:: getComponentAt в классе Component
Параметры:: p - точка.
Возвращает:: возвращает компонент, содержащий точку, или null если компонент не содержит точку.
С:: JDK1.1
См. также:: Component.contains(int, int)

getMousePosition

public Point getMousePosition(boolean allowChildren)
                       throws HeadlessException

Возвращает позицию указателя мыши в пространстве координат этого Container, если Container находится под указателем мыши, в противном случае возвращает null. Этот метод аналогичен Component.getMousePosition() за исключением того, что он может учитывать дочерние элементы Container. Если allowChildren равно false, этот метод возвращает ненулевое значение только в том случае, если указатель мыши находится непосредственно над Container, а не над частью, скрытой дочерними элементами. Если allowChildren равно true, этот метод возвращает ненулевое значение, если указатель мыши находится над Container или любыми его потомками.

Параметры:: allowChildren - true, если необходимо учитывать дочерние элементы
Возвращает:: координаты мыши относительно этого Component, или null
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
С:: 1.5
См. также:: Component.getMousePosition()

findComponentAt

public Component findComponentAt(int x,
                                 int y)

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

Метод findComponentAt отличается от getComponentAt тем, что getComponentAt ищет только непосредственные дочерние элементы контейнера; если содержащий компонент является контейнером, findComponentAt будет искать этот дочерний элемент, чтобы найти вложенный компонент.

Параметры:: x - координата x; y - координата y
Возвращает:: null, если компонент не содержит позицию. Если в запрошенной точке нет дочернего компонента, а точка находится в границах контейнера, возвращается сам контейнер.
С:: 1.2
См. также:: Component.contains(int, int), getComponentAt(int, int)

findComponentAt

public Component findComponentAt(Point p)

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

Параметры:: p - точка.
Возвращает:: null, если компонент не содержит позицию. Если в запрошенной точке нет дочернего компонента, а точка находится в границах контейнера, возвращается сам контейнер.
Выбрасывает:: NullPointerException - если p является null
С:: 1.2
См. также:: Component.contains(int, int), getComponentAt(int, int)

addNotify

public void addNotify()

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

Переопределяет:: addNotify в классе Component
См. также:: Component.isDisplayable(), removeNotify()

removeNotify

public void removeNotify()

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

Переопределяет:: removeNotify в классе Component
См. также:: Component.isDisplayable(), addNotify()

isAncestorOf

public boolean isAncestorOf(Component c)

Проверяет, содержится ли компонент в иерархии компонентов этого контейнера.

Параметры:: c - компонент
Возвращает:: true если он является предком; false в противном случае.
С:: JDK1.1

paramString

protected String paramString()

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

Переопределяет:: paramString в классе Component
Возвращает:: строку параметров этого контейнера

list

public void list(PrintStream out,
                 int indent)

Выводит список этого контейнера в указанный поток вывода. Вывод начинается с указанного отступа.

Непосредственные дочерние элементы контейнера выводятся с отступом в indent+1. Дочерние элементы этих дочерних элементов выводятся с отступом в indent+2 и так далее.

Переопределяет:: list в классе Component
Параметры:: out - поток вывода; indent - количество пробелов для отступа
Выбрасывает:: NullPointerException - если out является null
С:: JDK1.0
См. также:: Component.list(java.io.PrintStream, int)

list

public void list(PrintWriter out,
                 int indent)

Выводит список, начиная с указанного отступа, в указанный объект PrintWriter.

Переопределяет:: list в классе Component
Параметры:: out - объект PrintWriter; indent - количество пробелов для отступа
Выбрасывает:: NullPointerException - если out является null
С:: JDK1.1
См. также:: Component.list(java.io.PrintWriter, int)

setFocusTraversalKeys

public void setFocusTraversalKeys(int id,
                                  Set<? extends AWTKeyStroke> keystrokes)

Устанавливает клавиши перемещения фокуса для заданной операции перемещения для этого контейнера.

Значения по умолчанию для клавиш перемещения фокуса контейнера зависят от реализации. Sun рекомендует, чтобы все реализации для определенной нативной платформы использовали одни и те же значения по умолчанию. Рекомендации для Windows и Unix приведены ниже. Эти рекомендации используются в реализациях Sun AWT.

Идентификатор	Значение	По умолчанию
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	Нормальное перемещение фокуса на клавиатуре вперед	TAB при KEY_PRESSED, CTRL-TAB при KEY_PRESSED
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	Нормальное перемещение фокуса на клавиатуре назад	SHIFT-TAB при KEY_PRESSED, CTRL-SHIFT-TAB при KEY_PRESSED
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	Переход на один уровень вверх по циклу перемещения фокуса	нет
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS		Переход на один уровень вниз по циклу перемещения фокуса	нет

Для отключения клавиши перемещения используйте пустой набор; рекомендуется использовать Collections.EMPTY_SET.

Используя API AWTKeyStroke, код клиента может указать, на каком из двух определенных событий KeyEvents, KEY_PRESSED или KEY_RELEASED, произойдет операция перемещения фокуса. Однако, независимо от того, какое событие KeyEvent указано, все события KeyEvents, связанные с клавишей перемещения фокуса, включая связанное событие KEY_TYPED, будут потреблены и не будут переданы ни одному контейнеру. Это ошибка во время выполнения, если указать событие KEY_TYPED для сопоставления с операцией перемещения фокуса или сопоставить одно и то же событие с несколькими операциями перемещения фокуса по умолчанию.

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

Этот метод может выбросить ClassCastException если какой-либо Object в keystrokes не является AWTKeyStroke.

Переопределяет:: setFocusTraversalKeys в классе Component
Параметры:: id - одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS; keystrokes - набор AWTKeyStroke для указанной операции
Выбрасывает:: IllegalArgumentException - если id не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS, или если keystrokes содержит null, или если какой-либо keystroke представляет событие KEY_TYPED, или если какой-либо keystroke уже сопоставлен с другой операцией перемещения фокуса для этого контейнера
С:: 1.4
См. также:: getFocusTraversalKeys(int), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

Переопределяет:: getFocusTraversalKeys в классе Component
Параметры:: id - одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
Возвращает:: набор AWTKeyStrokes для заданной операции. Набор будет неизменяемым и может быть пустым. null никогда не будет возвращен.
Выбрасывает:: IllegalArgumentException - если id не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
С:: 1.4
См. также:: setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

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

Переопределяет:: areFocusTraversalKeysSet в классе Component
Параметры:: id - одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
Возвращает:: true если набор клавиш перемещения фокуса для заданной операции перемещения фокуса явно определен для этого компонента; false в противном случае.
Выбрасывает:: IllegalArgumentException - если id не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
С:: 1.4

isFocusCycleRoot

public boolean isFocusCycleRoot(Container container)

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

Overrides:: isFocusCycleRoot в классе Component
Parameters:: container - контейнер, который нужно проверить
Returns:: true , если указанный контейнер является корнем цикла фокуса этого контейнера; false в противном случае
Since:: 1.4
See Also:: isFocusCycleRoot()

setFocusTraversalPolicy

public void setFocusTraversalPolicy(FocusTraversalPolicy policy)

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

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

Parameters:: policy - новая политика перемещения фокуса для этого контейнера
Since:: 1.4
See Also:: getFocusTraversalPolicy(), setFocusCycleRoot(boolean), isFocusCycleRoot(java.awt.Container)

getFocusTraversalPolicy

public FocusTraversalPolicy getFocusTraversalPolicy()

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

Returns:: политика перемещения фокуса этого контейнера или null, если этот контейнер не является корнем цикла фокуса.
Since:: 1.4
See Also:: setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), setFocusCycleRoot(boolean), isFocusCycleRoot(java.awt.Container)

isFocusTraversalPolicySet

public boolean isFocusTraversalPolicySet()

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

Returns:: true , если для этого контейнера явно задана политика перемещения фокуса; false в противном случае.
Since:: 1.4

setFocusCycleRoot

public void setFocusCycleRoot(boolean focusCycleRoot)

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

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

Parameters:: focusCycleRoot - указывает, является ли этот контейнер корнем цикла перемещения фокуса
Since:: 1.4
See Also:: isFocusCycleRoot(), setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), getFocusTraversalPolicy(), ContainerOrderFocusTraversalPolicy, setFocusTraversalPolicyProvider(boolean)

isFocusCycleRoot

public boolean isFocusCycleRoot()

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

Returns:: является ли этот контейнер корнем цикла перемещения фокуса
Since:: 1.4
See Also:: setFocusCycleRoot(boolean), setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), getFocusTraversalPolicy(), ContainerOrderFocusTraversalPolicy

setFocusTraversalPolicyProvider

public final void setFocusTraversalPolicyProvider(boolean provider)

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

Parameters:: provider - указывает, будет ли этот контейнер использоваться для предоставления политики перемещения фокуса
Since:: 1.5
See Also:: setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), getFocusTraversalPolicy(), isFocusTraversalPolicyProvider()

isFocusTraversalPolicyProvider

public final boolean isFocusTraversalPolicyProvider()

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

Returns:: true , если этот контейнер предоставляет политику перемещения фокуса; false в противном случае
Since:: 1.5
See Also:: setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), getFocusTraversalPolicy(), setFocusCycleRoot(boolean), setFocusTraversalPolicyProvider(boolean)

transferFocusDownCycle

public void transferFocusDownCycle()

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

Since:: 1.4
See Also:: Component.requestFocus(), isFocusCycleRoot(java.awt.Container), setFocusCycleRoot(boolean)

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation o)

Устанавливает свойство ComponentOrientation этого контейнера и всех компонентов, содержащихся в нём.

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

Overrides:: applyComponentOrientation в классе Component
Parameters:: o - новая ориентация компонента этого контейнера и компонентов, содержащихся в нём.
Throws:: NullPointerException - если orientation равно null.
Since:: 1.4
See Also:: Component.setComponentOrientation(java.awt.ComponentOrientation), Component.getComponentOrientation(), invalidate()

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

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

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

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

Overrides:: addPropertyChangeListener в классе Component
Parameters:: listener - добавляемый PropertyChangeListener
See Also:: Component.removePropertyChangeListener(java.beans.PropertyChangeListener), addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)

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

Шрифт этого контейнера ("font")
Цвет фона этого контейнера ("background")
Цвет текста этого контейнера ("foreground")
Возможность получения фокуса этого контейнера ("focusable")
Состояние включения клавиш перехода по фокусу ("focusTraversalKeysEnabled")
Набор клавиш перехода вперед ("forwardFocusTraversalKeys")
Набор клавиш перехода назад ("backwardFocusTraversalKeys")
Набор клавиш перехода наверх ("upCycleFocusTraversalKeys")
Набор клавиш перехода вниз ("downCycleFocusTraversalKeys")
Политика перехода по фокусу ("focusTraversalPolicy")
Состояние корневого элемента цикла фокуса ("focusCycleRoot")
Состояние поставщика политики перехода по фокусу ("focusTraversalPolicyProvider")

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

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

Переопределяет:: addPropertyChangeListener в классе Component
Параметры:: propertyName - одно из имен свойств, перечисленных выше; listener - добавляемый обработчик событий изменения свойств (PropertyChangeListener)
См. также:: addPropertyChangeListener(java.beans.PropertyChangeListener), Component.removePropertyChangeListener(java.beans.PropertyChangeListener)

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.