Класс Контейнер

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

С:

1.0

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`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)`	Возвращает, является ли указанный контейнер корнем цикла перехода фокуса цикла перехода фокуса этого контейнера.
`final 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(int index)`	Удаляет компонент, указанный `index`, из этого контейнера.
`void`	`remove(Component comp)`	Удаляет указанный компонент из этого контейнера.

`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)`	Устанавливает политику обхода фокуса, которая будет управлять обходом клавиатуры по потомкам этого контейнера, если этот контейнер является корнем цикла фокуса.
`final 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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, 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

Подробное описание конструкторов

Контейнер

public Container()

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

Подробное описание методов

getComponentCount

public int getComponentCount()

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

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

Возвращает:

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

С момента:

1.1

См. также:

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 есть верхний отступ, который соответствует высоте заголовка рамки.

Возвращает:

отступы этого контейнера.

С момента:

1.1

См. также:

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) вместо него.

Параметры:

name - имя добавляемого компонента

comp - добавляемый компонент

Возвращает:

добавляемый компонент

Исключения:

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 для добавления компонента в конец

Возвращает:

добавляемый компонент

Исключения:

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

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

Parameters:

comp - компонент, который нужно добавить

constraints - объект, определяющий ограничения компоновки для этого компонента

Throws:

NullPointerException - если comp является null

Since:

1.1

See Also:

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

Parameters:

comp - компонент, который нужно добавить

constraints - объект, определяющий ограничения компоновки для этого

index - позиция в списке контейнера, в который нужно вставить компонент; -1 означает вставить в конец компонента

Throws:

NullPointerException - если comp является null

IllegalArgumentException - если index является недопустимым (см. addImpl(java.awt.Component, java.lang.Object, int) для подробностей)

See Also:

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)

Parameters:

comp - компонент, который нужно добавить

constraints - объект, определяющий ограничения компоновки для этого компонента

index - позиция в списке контейнера, в который нужно вставить компонент, где -1 означает добавление в конец

Throws:

IllegalArgumentException - если index является недопустимым; если comp является дочерним элементом этого контейнера, допустимый диапазон — [-1, getComponentCount()-1]; если компонент не является дочерним элементом этого контейнера, допустимый диапазон — [-1, getComponentCount()]

IllegalArgumentException - если добавляемый компонент является предком этого контейнера

IllegalArgumentException - если добавляется окно в контейнер

NullPointerException - если comp является null

Since:

1.1

See Also:

add(Component)
add(Component, int)
add(Component, java.lang.Object)
invalidate()
LayoutManager
LayoutManager2

remove

public void remove(int index)

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

Parameters:

index - индекс компонента, который нужно удалить

Throws:

ArrayIndexOutOfBoundsException - если index не находится в диапазоне [0, getComponentCount()-1]

Since:

1.1

See Also:

add(java.awt.Component)
invalidate()
validate()
getComponentCount()

remove

public void remove(Component comp)

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

Parameters:

comp - компонент, который нужно удалить

Throws:

NullPointerException - если comp является null

See Also:

add(java.awt.Component)
invalidate()
validate()
remove(int)

removeAll

public void removeAll()

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

See Also:

add(java.awt.Component)
remove(int)
invalidate()

getLayout

public LayoutManager getLayout()

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

Returns:

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

See Also:

doLayout()
setLayout(java.awt.LayoutManager)

setLayout

public void setLayout(LayoutManager mgr)

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

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

Parameters:

mgr - указанный менеджер компоновки

See Also:

doLayout()
getLayout()
invalidate()

doLayout

public void doLayout()

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

Overrides:

doLayout в классе Component

Since:

1.1

See Also:

layout

@Deprecated public void layout()

Deprecated.

С версии JDK 1.1 заменено на doLayout().

Overrides:: layout в классе Component

isValidateRoot

public boolean isValidateRoot()

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

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

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

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

Returns:

является ли этот контейнер корнем валидации

Since:

1.7

See Also:

invalidate

public void invalidate()

Невалидирует контейнер.

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

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

Overrides:

invalidate в классе Component

See Also:

validate

public void validate()

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

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

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

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

Overrides:

validate в классе Component

See Also:

add(java.awt.Component)
invalidate()
isValidateRoot()
JComponent.revalidate()
validateTree()

validateTree

protected void validateTree()

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

See Also:

doLayout()
validate()

setFont

public void setFont(Font f)

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

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

Overrides:

setFont в классе Component

Parameters:

f - Шрифт, который станет шрифтом этого контейнера.

Since:

1.0

See Also:

getPreferredSize

public Dimension getPreferredSize()

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

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

Overrides:

getPreferredSize в классе Component

Returns:

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

See Also:

preferredSize

@Deprecated public Dimension preferredSize()

Deprecated.

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

Описание скопировано из класса: Component

Возвращает предпочтительный размер компонента.

Overrides:: preferredSize в классе Component
Returns:: предпочтительный размер компонента

getMinimumSize

public Dimension getMinimumSize()

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

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

Overrides:

getMinimumSize в классе Component

Returns:

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

Since:

1.1

See Also:

minimumSize

@Deprecated public Dimension minimumSize()

Deprecated.

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

Описание скопировано из класса: Component

Возвращает минимальный размер этого компонента.

Overrides:: minimumSize в классе Component
Returns:: минимальный размер этого компонента

getMaximumSize

public Dimension getMaximumSize()

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

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

Overrides:

getMaximumSize в классе Component

Returns:

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

See Also:

getAlignmentX

public float getAlignmentX()

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

Overrides:: getAlignmentX в классе Component
Returns:: горизонтальное выравнивание этого компонента

getAlignmentY

public float getAlignmentY()

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

Overrides:: getAlignmentY в классе Component
Returns:: вертикальное выравнивание этого компонента

paint

public void paint(Graphics g)

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

Overrides:

paint в классе Component

Parameters:

g - указанное графическое окно

See Also:

Component.update(Graphics)

update

public void update(Graphics g)

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

Overrides:

update в классе Component

Parameters:

g - указанное графическое окно

See Also:

Component.update(Graphics)

print

public void print(Graphics g)

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

Overrides:

print в классе Component

Parameters:

g - указанное графическое окно

See Also:

Component.update(Graphics)

paintComponents

public void paintComponents(Graphics g)

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

Parameters:

g - контекст графики.

See Also:

printComponents

public void printComponents(Graphics g)

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

Parameters:

g - контекст графики.

See Also:

addContainerListener

public void addContainerListener(ContainerListener l)

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

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

Parameters:

l - слушатель контейнера

See Also:

removeContainerListener(java.awt.event.ContainerListener)
getContainerListeners()

removeContainerListener

public void removeContainerListener(ContainerListener l)

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

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

Parameters:

l - слушатель контейнера

See Also:

addContainerListener(java.awt.event.ContainerListener)
getContainerListeners()

getContainerListeners

public ContainerListener[] getContainerListeners()

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

Returns:

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

Since:

1.4

See Also:

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

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

Overrides:

getListeners в классе Component

Type Parameters:

T - тип слушателей

Parameters:

listenerType - тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, который наследуется от java.util.EventListener

Returns:

массив всех объектов, зарегистрированных в качестве FooListener в этом контейнере, или пустой массив, если такие слушатели не были добавлены

Throws:

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

NullPointerException - если listenerType является null

Since:

1.3

See Also:

getContainerListeners()

processEvent

protected void processEvent(AWTEvent e)

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

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

Overrides:

processEvent в классе Component

Parameters:

e - событие

See Also:

processContainerEvent

protected void processContainerEvent(ContainerEvent e)

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

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

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

Parameters:

e - событие контейнера

See Also:

Component.enableEvents(long)

deliverEvent

@Deprecated public void deliverEvent(Event e)

Устарело.

С версии JDK 1.1 заменено на dispatchEvent(AWTEvent e)

Overrides:: deliverEvent в классе Component
Parameters:: e - событие для доставки

getComponentAt

public Component getComponentAt(int x, int y)

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

Overrides:

getComponentAt в классе Component

Parameters:

x - координата x

y - координата y

Returns:

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

Since:

1.1

See Also:

Component.contains(int, int)

locate

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

Устарело.

С версии JDK 1.1 заменено на getComponentAt(int, int).

Описание скопировано из класса: Component

Возвращает компонент, занимающий указанную позицию (этот компонент, или непосредственный дочерний компонент, или null, если ни один из первых двух не занимает местоположение).

Overrides:: locate в классе Component
Parameters:: x - координата x для поиска компонентов; y - координата y для поиска компонентов
Returns:: компонент в указанном месте или null

getComponentAt

public Component getComponentAt(Point p)

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

Overrides:

getComponentAt в классе Component

Parameters:

p - точка.

Returns:

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

Since:

1.1

See Also:

Component.contains(int, int)

getMousePosition

public Point getMousePosition(boolean allowChildren) throws HeadlessException

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

Parameters:

allowChildren - true, если необходимо учитывать дочерние элементы

Returns:

координаты мыши относительно этого Component, или null

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true

Since:

1.5

See Also:

Component.getMousePosition()

findComponentAt

public Component findComponentAt(int x, int y)

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

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

Parameters:

x - координата x

y - координата y

Returns:

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

Since:

1.2

See Also:

findComponentAt

public Component findComponentAt(Point p)

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

Parameters:

p - точка.

Returns:

Throws:

NullPointerException - если p равно null

Since:

1.2

See Also:

addNotify

public void addNotify()

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

Overrides:

addNotify в классе Component

See Also:

removeNotify

public void removeNotify()

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

Overrides:

removeNotify в классе Component

See Also:

isAncestorOf

public boolean isAncestorOf(Component c)

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

Parameters:: c - компонент
Returns:: true если он является предком; false в противном случае.
Since:: 1.1

paramString

protected String paramString()

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

Overrides:: paramString в классе Component
Returns:: строка параметров этого контейнера

list

public void list(PrintStream out, int indent)

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

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

Overrides:

list в классе Component

Parameters:

out - поток вывода

indent - количество пробелов для отступа

Throws:

NullPointerException - если out равен null

Since:

1.0

See Also:

Component.list(java.io.PrintStream, int)

list

public void list(PrintWriter out, int indent)

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

Overrides:

list в классе Component

Parameters:

out - поток вывода

indent - количество пробелов для отступа

Throws:

NullPointerException - если out равен null

Since:

1.1

See Also:

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 при нажатии, CTRL-TAB при нажатии
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	Нормальное перемещение фокуса по клавиатуре назад	SHIFT-TAB при нажатии, CTRL-SHIFT-TAB при нажатии
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	Переход на один цикл перемещения фокуса вверх	нет
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS	Переход на один цикл перемещения фокуса вниз	нет

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

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

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

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

Overrides:

setFocusTraversalKeys в классе Component

Parameters:

id - одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

keystrokes - набор AWTKeyStroke для заданной операции

Throws:

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 уже сопоставлен с другой операцией перемещения фокуса для этого контейнера

Since:

1.4

See Also:

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

Overrides:

getFocusTraversalKeys в классе Component

Parameters:

Returns:

набор AWTKeyStrokes для заданной операции. Набор будет неизменяемым и может быть пустым. null никогда не возвращается.

Throws:

Since:

1.4

See Also:

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

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

Overrides:: areFocusTraversalKeysSet в классе Component
Parameters:: id - одно из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
Returns:: true если набор клавиш перемещения фокуса для заданной операции перемещения фокуса был явно определен для этого компонента; false в противном случае.
Throws:: IllegalArgumentException - если id не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
Since:: 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:

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:

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

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

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

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

Overrides:

addPropertyChangeListener в классе Component

Parameters:

propertyName - одно из имен свойств, перечисленных выше

listener - добавляемый PropertyChangeListener

See Also:

© 1993, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/Container.html