Класс 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
См. также:
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​(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)

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

Конструкторы

Container

public Container()

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

Методы

getComponentCount

public int getComponentCount()

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

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

Возвращает:
количество компонентов в этой панели.
С:
1.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, например, имеет верхний отступ, соответствующий высоте заголовка рамки.

Возвращает:
отступы этого контейнера.
С:
1.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) вместо этого.

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

Параметры:
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 для добавления в конец
Возвращает:
компонент 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
С:
1.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).

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

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

super.addImpl(comp, constraints, index)

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

Параметры:
comp - компонент, который нужно добавить
constraints - объект, выражающий ограничения макета для этого компонента
index - позиция в списке контейнера, в которую нужно вставить компонент, где -1 означает добавление в конец
Исключения:
IllegalArgumentException - если index недопустим; если comp является потомком этого контейнера, допустимый диапазон [-1, getComponentCount()-1]; если компонент не является потомком этого контейнера, допустимый диапазон [-1, getComponentCount()]
IllegalArgumentException - если comp является предком этого контейнера
IllegalArgumentException - если добавляется окно в контейнер
NullPointerException - если comp имеет значение null
С:
1.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]
С:
1.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
С:
1.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 - Шрифт, который должен стать шрифтом этого контейнера.
С:
1.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().

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

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

Переопределяет:
preferredSize в классе Component
Возвращает:
предпочтительный размер компонента

getMinimumSize

public Dimension getMinimumSize()

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

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

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

minimumSize

@Deprecated
public Dimension minimumSize()
Устаревшее.
С версии JDK 1.1 заменено на getMinimumSize().

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

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

Переопределяет:
minimumSize в классе Component
Возвращает:
минимальный размер этого компонента

getMaximumSize

public Dimension getMaximumSize()

Возвращает максимальный размер этого контейнера. Если максимальный размер не был явно задан с помощью Component.setMaximumSize(Dimension), и LayoutManager, установленный на этот 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 - заданное окно Graphics
См. также:
Component.update(Graphics)

update

public void update(Graphics g)

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

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

print

public void print(Graphics g)

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

Переопределяет:
print в классе Component
Параметры:
g - заданное окно Graphics
См. также:
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
Параметры типа:
T - тип слушателей
Параметры:
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
Параметры:
e - событие для передачи

getComponentAt

public Component getComponentAt(int x,
                                int y)

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

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

locate

@Deprecated
public Component locate(int x,
                        int y)
Устарело.
С версии JDK 1.1, заменено на getComponentAt(int, int).

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

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

Переопределяет:
locate в классе Component
Параметры:
x - координата x для поиска компонентов
y - координата y для поиска компонентов
Возвращает:
компонент в указанном месте или null

getComponentAt

public Component getComponentAt(Point p)

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

Переопределяет:
getComponentAt в классе Component
Параметры:
p - точка.
Возвращает:
возвращает компонент, содержащий точку, или null если компонент не содержит точку.
С тех пор:
1.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 ищет только непосредственные дочерние элементы Container; если содержащий компонент является контейнером, findComponentAt будет искать этот дочерний элемент, чтобы найти вложенный компонент.

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

findComponentAt

public Component findComponentAt(Point p)

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

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

Параметры:
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 в противном случае.
С:
1.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
С:
1.0
См. также:
Component.list(java.io.PrintStream, int)

list

public void list(PrintWriter out,
                 int indent)

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

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

Переопределяет:
list в классе Component
Параметры:
out - объект PrintWriter
indent - количество пробелов для отступа
Исключения:
NullPointerException - если out является null
С:
1.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 указано, все события KeyEvent, связанные с клавишей перехода фокуса, включая связанное событие 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.

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)

Возвращает значение, указывающее, является ли указанный Container корнем цикла перемещения фокуса для этого 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")
  • набор клавиш FORWARD_TRAVERSAL_KEYS ("forwardFocusTraversalKeys")
  • набор клавиш BACKWARD_TRAVERSAL_KEYS ("backwardFocusTraversalKeys")
  • набор клавиш UP_CYCLE_TRAVERSAL_KEYS ("upCycleFocusTraversalKeys")
  • набор клавиш DOWN_CYCLE_TRAVERSAL_KEYS ("downCycleFocusTraversalKeys")
  • политика перемещения фокуса этого контейнера ("focusTraversalPolicy")
  • состояние корня цикла перемещения фокуса ("focusCycleRoot")
Обратите внимание, что если этот контейнер наследует связанное свойство, событие не будет сгенерировано в ответ на изменение унаследованного свойства.

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

Переопределяет:
addPropertyChangeListener в классе Component
Параметры:
listener - добавляемый слушатель PropertyChangeListener
См. также:
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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/Container.html

Spec-Zone .ru
спецификации, руководства, описания, API