Класс Container

java.lang.Object

java.awt.Component

java.awt.Container

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

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

public class Container extends Component

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

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

Примечание: Подробную информацию о подсистеме фокуса см. в разделе Как использовать подсистему фокуса руководства Учебник по Java, а также в спецификации фокуса.

Начиная с:

1.0

См. также:

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

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

Вложенные классы и интерфейсы, объявленные в классе Component

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

Краткое описание полей

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе ImageObserver

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

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

Конструктор	Описание
`Container()`	Создает новый 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()`	Делает этот Container отображаемым, подключая его к собственному экранному ресурсу.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список прослушивателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список прослушивателей для указанного свойства.
`void`	`applyComponentOrientation(ComponentOrientation o)`	Задает свойство `ComponentOrientation` этого контейнера и всех содержащихся в нем компонентов.
`boolean`	`areFocusTraversalKeysSet(int id)`	Возвращает, был ли явно определен для этого Container набор клавиш перехода фокуса для указанной операции перехода фокуса.
`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)`	Возвращает набор клавиш перехода фокуса для заданной операции перехода в этом Container.
`FocusTraversalPolicy`	`getFocusTraversalPolicy()`	Возвращает политику перехода фокуса, управляющую перемещением клавиатурного фокуса между дочерними элементами этого Container, или null, если этот Container не является корнем цикла фокуса.
`Insets`	`getInsets()`	Определяет внутренние отступы этого контейнера, указывающие размер его границы.
`LayoutManager`	`getLayout()`	Получает менеджер компоновки этого контейнера.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, зарегистрированных в данный момент как `FooListener`s для этого `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()`	Возвращает, является ли этот Container корнем цикла перехода фокуса.
`boolean`	`isFocusCycleRoot(Container container)`	Возвращает, является ли указанный Container корнем цикла фокуса для цикла перехода фокуса этого Container.
`final boolean`	`isFocusTraversalPolicyProvider()`	Возвращает, предоставляет ли этот контейнер политику перехода фокуса.
`boolean`	`isFocusTraversalPolicySet()`	Возвращает, была ли политика перехода фокуса явно задана для этого Container.
`boolean`	`isValidateRoot()`	Показывает, является ли этот контейнер корнем проверки.
`void`	`layout()`	Устарело. Начиная с JDK версии 1.1 заменен методом `doLayout()`.
`void`	`list(PrintStream out, int indent)`	Выводит список содержимого этого контейнера в указанный выходной поток.
`void`	`list(PrintWriter out, int indent)`	Выводит список с заданным отступом в указанный объект записи для печати.
`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()`	Делает этот Container неотображаемым, разрывая соединение с его собственным экранным ресурсом.
`void`	`setComponentZOrder(Component comp, int index)`	Перемещает указанный компонент на заданный индекс z-порядка в контейнере.
`void`	`setFocusCycleRoot(boolean focusCycleRoot)`	Задает, является ли этот Container корнем цикла перехода фокуса.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Задает набор клавиш перехода фокуса для указанной операции перехода в этом Container.
`void`	`setFocusTraversalPolicy(FocusTraversalPolicy policy)`	Задает политику перехода фокуса, управляющую перемещением клавиатурного фокуса между дочерними элементами этого Container, если он является корнем цикла фокуса.
`final void`	`setFocusTraversalPolicyProvider(boolean provider)`	Задает, будет ли этот контейнер использоваться для предоставления политики перехода фокуса.
`void`	`setFont(Font f)`	Задает шрифт этого контейнера.
`void`	`setLayout(LayoutManager mgr)`	Задает менеджер компоновки этого контейнера.
`void`	`transferFocusDownCycle()`	Переводит фокус на один цикл перехода вниз.
`void`	`update(Graphics g)`	Обновляет контейнер.
`void`	`validate()`	Проверяет этот контейнер и все его подкомпоненты.
`protected void`	`validateTree()`	Рекурсивно обходит дерево контейнеров и заново вычисляет компоновку всех поддеревьев, для которых она требуется (помеченных как недействительные).

Методы, объявленные в классе 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

Методы, объявленные в классе Object

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

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

Container

public Container()

Создает новый Container. Классы 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^-го значения не существует.

См. также:

getComponents

public Component[] getComponents()

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

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

Возвращает:

массив всех компонентов этого контейнера.

См. также:

getInsets

public Insets getInsets()

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

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

Возвращает:

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

Начиная с версии:

1.1

См. также:

insets

@Deprecated public Insets insets()

Устарел.

Начиная с JDK 1.1 заменен методом getInsets().

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

Возвращает:: внутренние отступы этого контейнера

add

public Component add(Component comp)

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

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

Параметры:

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

Возвращает:

аргумент-компонент

Вызывает исключение:

NullPointerException — если comp равен null

См. также:

add

public Component add(String name, Component comp)

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

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

Параметры:

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

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

Возвращает:

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

Вызывает исключение:

NullPointerException — если comp равен null

См. также:

add

public Component add(Component comp, int index)

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

Параметры:

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

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

Возвращает:

компонент comp

Вызывает исключение:

NullPointerException — если comp равен null

IllegalArgumentException — если index недопустим (подробности см. в addImpl(Component, Object, int))

См. также:

setComponentZOrder

public void setComponentZOrder(Component comp, int index)

Перемещает указанный компонент на заданный индекс 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

public int getComponentZOrder(Component comp)

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

Параметры:

comp — компонент, индекс которого запрашивается

Возвращает:

индекс z-порядка компонента; в противном случае возвращает -1, если компонент null или не принадлежит контейнеру

Начиная с версии:

1.5

См. также:

add

public void add(Component comp, Object constraints)

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

Параметры:

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

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

Вызывает исключение:

NullPointerException — если comp равен null

Начиная с версии:

1.1

См. также:

add

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

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

Параметры:

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

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

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

Вызывает исключение:

NullPointerException — если comp равен null

IllegalArgumentException — если index недопустим (подробности см. в addImpl(Component, Object, int))

См. также:

addImpl

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

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

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

Для класса GridBagLayout требуется объект GridBagConstraints. Передача объекта ограничений неверного типа приводит к IllegalArgumentException.

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

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

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

super.addImpl(comp, constraints, index)

Параметры:

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

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

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

Вызывает исключение:

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

IllegalArgumentException — если comp является предком этого контейнера

IllegalArgumentException — при добавлении окна в контейнер

NullPointerException — если comp равен null

Начиная с версии:

1.1

См. также:

remove

public void remove(int index)

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

Параметры:

index — индекс удаляемого компонента

Вызывает исключение:

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

Начиная с версии:

1.1

См. также:

remove

public void remove(Component comp)

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

Параметры:

comp — удаляемый компонент

Вызывает исключение:

NullPointerException — если comp равен null

См. также:

removeAll

public void removeAll()

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

См. также:

getLayout

public LayoutManager getLayout()

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

Возвращает:

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

См. также:

setLayout

public void setLayout(LayoutManager mgr)

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

Параметры:

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

См. также:

doLayout

public void doLayout()

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

Переопределяет:

doLayout в классе Component

Начиная с версии:

1.1

См. также:

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

public void invalidate()

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

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

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

Переопределяет:

invalidate в классе Component

См. также:

validate

public void validate()

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

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

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

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

Переопределяет:

validate в классе Component

См. также:

validateTree

protected void validateTree()

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

См. также:

setFont

public void setFont(Font f)

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

Переопределяет:

setFont в классе Component

Параметры:

f — шрифт, который будет установлен для этого контейнера.

Начиная с версии:

1.0

См. также:

getPreferredSize

public Dimension getPreferredSize()

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

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

Переопределяет:

getPreferredSize в классе Component

Возвращает:

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

См. также:

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

См. также:

minimumSize

@Deprecated public Dimension minimumSize()

Устарело.

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

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

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

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

getMaximumSize

public Dimension getMaximumSize()

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

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

Переопределяет:

getMaximumSize в классе Component

Возвращает:

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

См. также:

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 — указанное графическое окно

См. также:

update

public void update(Graphics g)

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

Переопределяет:

update в классе Component

Параметры:

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

См. также:

print

public void print(Graphics g)

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

Переопределяет:

print в классе Component

Параметры:

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

См. также:

paintComponents

public void paintComponents(Graphics g)

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

Параметры:

g — графический контекст.

См. также:

printComponents

public void printComponents(Graphics g)

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

Параметры:

g — графический контекст.

См. также:

addContainerListener

public void addContainerListener(ContainerListener l)

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

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

Параметры:

l — прослушиватель контейнера

См. также:

removeContainerListener

public void removeContainerListener(ContainerListener l)

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

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

Параметры:

l — прослушиватель контейнера

См. также:

getContainerListeners

public ContainerListener[] getContainerListeners()

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

Возвращает:

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

Начиная с:

1.4

См. также:

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

См. также:

processEvent

protected void processEvent(AWTEvent e)

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

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

Переопределяет:

processEvent в классе Component

Параметры:

e — событие

См. также:

processContainerEvent

protected void processContainerEvent(ContainerEvent e)

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

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

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

Параметры:

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

См. также:

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. Если компоненты перекрываются, возвращается самый верхний дочерний компонент. Он определяется как компонент с наименьшим индексом, который сообщает, что заданная точка находится внутри него, посредством Component.contains(); однако компоненты с собственными нативными объектами имеют приоритет над компонентами без них (то есть лёгковесными компонентами).

Переопределяет:

getComponentAt в классе Component

Параметры:

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

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

Возвращает:

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

Начиная с:

1.1

См. также:

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

См. также:

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

См. также:

findComponentAt

public Component findComponentAt(int x, int y)

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

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

Параметры:

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

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

Возвращает:

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

Начиная с:

1.2

См. также:

findComponentAt

public Component findComponentAt(Point p)

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

Параметры:

p — точка.

Возвращает:

Выбрасывает:

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

Начиная с:

1.2

См. также:

addNotify

public void addNotify()

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

Переопределяет:

addNotify в классе Component

См. также:

removeNotify

public void removeNotify()

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

Переопределяет:

removeNotify в классе Component

См. также:

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

См. также:

list

public void list(PrintWriter out, int indent)

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

Переопределяет:

list в классе Component

Параметры:

out — объект печати

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

Выбрасывает:

NullPointerException — если out равно null

Начиная с:

1.1

См. также:

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

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

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

Если для Set указано значение null, этот контейнер наследует Set от родителя. Если для Set указано значение null у всех предков этого контейнера, используется Set по умолчанию текущего 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 - Set объектов AWTKeyStroke для указанной операции

Исключения:

IllegalArgumentException - если id не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS, если keystrokes содержит null, если какая-либо последовательность клавиш представляет событие KEY_TYPED или если какая-либо последовательность клавиш уже сопоставлена с другой операцией перемещения фокуса для этого контейнера

Начиная с версии:

1.4

См. также:

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

Переопределяет:

getFocusTraversalKeys в классе Component

Параметры:

Возвращает:

Set объектов AWTKeyStroke для указанной операции. Set будет неизменяемым и может быть пустым. Значение null никогда не возвращается.

Исключения:

Начиная с версии:

1.4

См. также:

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

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

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

isFocusCycleRoot

public boolean isFocusCycleRoot(Container container)

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

Переопределяет:

isFocusCycleRoot в классе Component

Параметры:

container - контейнер, который необходимо проверить

Возвращает:

true, если указанный контейнер является корнем цикла фокуса для этого контейнера; в противном случае — false

Начиная с версии:

1.4

См. также:

setFocusTraversalPolicy

public void setFocusTraversalPolicy(FocusTraversalPolicy policy)

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

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

Параметры:

policy - новая политика перемещения фокуса для этого контейнера

Начиная с версии:

1.4

См. также:

getFocusTraversalPolicy

public FocusTraversalPolicy getFocusTraversalPolicy()

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

Возвращает:

политику перемещения фокуса этого контейнера или null, если этот контейнер не является корнем цикла фокуса.

Начиная с версии:

1.4

См. также:

isFocusTraversalPolicySet

public boolean isFocusTraversalPolicySet()

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

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

setFocusCycleRoot

public void setFocusCycleRoot(boolean focusCycleRoot)

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

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

Параметры:

focusCycleRoot - указывает, является ли этот контейнер корнем цикла перемещения фокуса

Начиная с версии:

1.4

См. также:

isFocusCycleRoot

public boolean isFocusCycleRoot()

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

Возвращает:

сведения о том, является ли этот контейнер корнем цикла перемещения фокуса

Начиная с версии:

1.4

См. также:

setFocusTraversalPolicyProvider

public final void setFocusTraversalPolicyProvider(boolean provider)

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

Параметры:

provider - указывает, будет ли этот контейнер использоваться для предоставления политики перемещения фокуса

Начиная с версии:

1.5

См. также:

isFocusTraversalPolicyProvider

public final boolean isFocusTraversalPolicyProvider()

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

Возвращает:

true, если этот контейнер предоставляет политику перемещения фокуса; в противном случае — false

Начиная с версии:

1.5

См. также:

transferFocusDownCycle

public void transferFocusDownCycle()

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

Начиная с версии:

1.4

См. также:

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation o)

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

Переопределяет:

applyComponentOrientation в классе Component

Параметры:

o - новая ориентация этого контейнера и содержащихся в нем компонентов.

Исключения:

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

Начиная с версии:

1.4

См. также:

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

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

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

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

Переопределяет:

addPropertyChangeListener в классе Component

Параметры:

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

См. также:

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

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

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

Переопределяет:

addPropertyChangeListener в классе Component

Параметры:

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

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

См. также:

© 1993, 2025, 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/25/docs/api/java.desktop/java/awt/Container.html