Класс 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.

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

Примечание: подробные сведения о подсистеме фокуса см. в разделе How to Use the Focus Subsystem руководства The Java Tutorial, а также в Focus Specification.

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

1.0

См. также:

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

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

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

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

Модификатор и тип	Класс	Описание
`protected class`	`Component.AccessibleAWTComponent`	Внутренний класс Component, используемый для обеспечения поддержки специальных возможностей по умолчанию.
`static enum`	`Component.BaselineResizeBehavior`	Перечисление распространенных способов изменения базовой линии компонента при изменении размера.
`protected class`	`Component.BltBufferStrategy`	Внутренний класс для побитового копирования (blitting) закадровых поверхностей на компонент.
`protected class`	`Component.FlipBufferStrategy`	Внутренний класс для переключения буферов (flipping) на компоненте.

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Модификатор и тип	Поле	Описание
`protected AccessibleContext`	`accessibleContext`	`AccessibleContext`, связанный с этим `Component`.
`static final float`	`BOTTOM_ALIGNMENT`	Удобная константа для `getAlignmentY`.
`static final float`	`CENTER_ALIGNMENT`	Удобная константа для `getAlignmentY` и `getAlignmentX`.
`static final float`	`LEFT_ALIGNMENT`	Удобная константа для `getAlignmentX`.
`static final float`	`RIGHT_ALIGNMENT`	Удобная константа для `getAlignmentX`.
`static final float`	`TOP_ALIGNMENT`	Удобная константа для `getAlignmentY()`.

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

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

Модификатор и тип	Поле	Описание
`static final int`	`ABORT`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что формирование изображения, отслеживаемого асинхронно, было прервано до его завершения.
`static final int`	`ALLBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что статическое изображение, которое ранее отрисовывалось, теперь полностью готово и может быть отрисовано снова в окончательном виде.
`static final int`	`ERROR`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что при асинхронном отслеживании изображения произошла ошибка.
`static final int`	`FRAMEBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что доступен еще один полный кадр ранее отрисовывавшегося многокадрового изображения для повторной отрисовки.
`static final int`	`HEIGHT`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что высота базового изображения теперь доступна и может быть получена из аргумента height метода обратного вызова imageUpdate.
`static final int`	`PROPERTIES`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что свойства изображения теперь доступны.
`static final int`	`SOMEBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что доступны дополнительные пиксели, необходимые для отрисовки масштабированного варианта изображения.
`static final int`	`WIDTH`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что ширина базового изображения теперь доступна и может быть получена из аргумента width метода обратного вызова imageUpdate.

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

Конструктор	Описание
`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()`	Определяет внутренние отступы (insets) этого контейнера, которые задают размер границы контейнера.
`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()`	Возвращает значение, указывающее, является ли этот Container корнем цикла обхода фокуса.
`boolean`	`isFocusCycleRoot(Container container)`	Возвращает значение, указывающее, является ли указанный Container корнем цикла фокуса для цикла обхода фокуса этого Container.
`final boolean`	`isFocusTraversalPolicyProvider()`	Возвращает значение, указывающее, предоставляет ли этот контейнер политику обхода фокуса.
`boolean`	`isFocusTraversalPolicySet()`	Возвращает значение, указывающее, была ли политика обхода фокуса явно установлена для этого Container.
`boolean`	`isValidateRoot()`	Указывает, является ли этот контейнер validate root.
`void`	`layout()`	Устарело. Начиная с версии JDK 1.1, заменено на `doLayout()`.
`void`	`list(PrintStream out, int indent)`	Выводит список этого контейнера в указанный выходной поток.
`void`	`list(PrintWriter out, int indent)`	Выводит список, начиная с указанного отступа, в указанный модуль записи печати (print writer).
`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, если этот Container является корнем цикла фокуса.
`final void`	`setFocusTraversalPolicyProvider(boolean provider)`	Устанавливает, будет ли этот контейнер использоваться для предоставления политики обхода фокуса.
`void`	`setFont(Font f)`	Устанавливает шрифт этого контейнера.
`void`	`setLayout(LayoutManager mgr)`	Устанавливает менеджер компоновки для этого контейнера.
`void`	`transferFocusDownCycle()`	Передает фокус на один цикл обхода фокуса вниз.
`void`	`update(Graphics g)`	Обновляет контейнер.
`void`	`validate()`	Проверяет корректность (validates) этого контейнера и всех его подкомпонентов.
`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

Модификатор и тип	Метод	Описание
`boolean`	`action(Event evt, Object what)`	Устарело. Начиная с версии JDK 1.1, этот компонент следует регистрировать как ActionListener на компоненте, генерирующем события действия.
`void`	`add(PopupMenu popup)`	Добавляет указанное всплывающее меню к компоненту.
`void`	`addComponentListener(ComponentListener l)`	Добавляет указанный слушатель компонентов для получения событий компонента от этого компонента.
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента при получении им фокуса ввода.
`void`	`addHierarchyBoundsListener(HierarchyBoundsListener l)`	Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
`void`	`addHierarchyListener(HierarchyListener l)`	Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
`void`	`addInputMethodListener(InputMethodListener l)`	Добавляет указанный слушатель методов ввода для получения событий метода ввода от этого компонента.
`void`	`addKeyListener(KeyListener l)`	Добавляет указанный слушатель клавиш для получения событий клавиатуры от этого компонента.
`void`	`addMouseListener(MouseListener l)`	Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
`void`	`addMouseMotionListener(MouseMotionListener l)`	Добавляет указанный слушатель перемещения мыши для получения событий перемещения мыши от этого компонента.
`void`	`addMouseWheelListener(MouseWheelListener l)`	Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента.
`Rectangle`	`bounds()`	Устарело. Начиная с версии JDK 1.1, заменено на `getBounds()`.
`int`	`checkImage(Image image, int width, int height, ImageObserver observer)`	Возвращает статус построения экранного представления указанного изображения.
`int`	`checkImage(Image image, ImageObserver observer)`	Возвращает статус построения экранного представления указанного изображения.
`protected AWTEvent`	`coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)`	Потенциально объединяет отправляемое событие с существующим событием.
`boolean`	`contains(int x, int y)`	Проверяет, содержит ли этот компонент указанную точку, где `x` и `y` определены относительно системы координат этого компонента.
`boolean`	`contains(Point p)`	Проверяет, содержит ли этот компонент указанную точку, где координаты точки x и y определены относительно системы координат этого компонента.
`Image`	`createImage(int width, int height)`	Создает закадровое отрисовываемое изображение для использования при двойной буферизации.
`Image`	`createImage(ImageProducer producer)`	Создает изображение из указанного поставщика изображений.
`VolatileImage`	`createVolatileImage(int width, int height)`	Создает изменяемое (volatile) закадровое отрисовываемое изображение для использования при двойной буферизации.
`VolatileImage`	`createVolatileImage(int width, int height, ImageCapabilities caps)`	Создает изменяемое (volatile) закадровое отрисовываемое изображение с заданными возможностями.
`void`	`disable()`	Устарело. Начиная с версии JDK 1.1, заменено на `setEnabled(boolean)`.
`protected final void`	`disableEvents(long eventsToDisable)`	Отключает доставку событий, определенных указанным параметром маски событий, этому компоненту.
`final void`	`dispatchEvent(AWTEvent e)`	Диспетчеризирует событие этому компоненту или одному из его подкомпонентов.
`void`	`enable()`	Устарело. Начиная с версии JDK 1.1, заменено на `setEnabled(boolean)`.
`void`	`enable(boolean b)`	Устарело. Начиная с версии JDK 1.1, заменено на `setEnabled(boolean)`.
`protected final void`	`enableEvents(long eventsToEnable)`	Включает доставку событий, определенных указанным параметром маски событий, этому компоненту.
`void`	`enableInputMethods(boolean enable)`	Включает или отключает поддержку методов ввода для этого компонента.
`protected void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)`	Поддержка оповещения об изменениях связанных свойств типа boolean.
`void`	`firePropertyChange(String propertyName, byte oldValue, byte newValue)`	Сообщает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, char oldValue, char newValue)`	Сообщает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, double oldValue, double newValue)`	Сообщает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, float oldValue, float newValue)`	Сообщает об изменении связанного свойства.
`protected void`	`firePropertyChange(String propertyName, int oldValue, int newValue)`	Поддержка оповещения об изменениях связанных свойств типа integer.
`void`	`firePropertyChange(String propertyName, long oldValue, long newValue)`	Сообщает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, short oldValue, short newValue)`	Сообщает об изменении связанного свойства.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддержка оповещения об изменениях связанных свойств типа Object.
`AccessibleContext`	`getAccessibleContext()`	Возвращает `AccessibleContext`, связанный с этим `Component`.
`Color`	`getBackground()`	Возвращает цвет фона этого компонента.
`int`	`getBaseline(int width, int height)`	Возвращает базовую линию.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior()`	Возвращает перечисление, указывающее, как базовая линия компонента изменяется при изменении размера.
`Rectangle`	`getBounds()`	Возвращает границы этого компонента в виде объекта `Rectangle`.
`Rectangle`	`getBounds(Rectangle rv)`	Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
`ColorModel`	`getColorModel()`	Возвращает экземпляр `ColorModel`, используемый для отображения компонента на устройстве вывода.
`ComponentListener[]`	`getComponentListeners()`	Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
`ComponentOrientation`	`getComponentOrientation()`	Возвращает языковую ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
`Cursor`	`getCursor()`	Возвращает курсор, установленный для компонента.
`DropTarget`	`getDropTarget()`	Возвращает `DropTarget`, связанный с этим `Component`.
`Container`	`getFocusCycleRootAncestor()`	Возвращает Container, который является корнем цикла перемещения фокуса для данного Component.
`FocusListener[]`	`getFocusListeners()`	Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
`boolean`	`getFocusTraversalKeysEnabled()`	Возвращает признак того, включены ли клавиши перемещения фокуса для этого Component.
`Font`	`getFont()`	Возвращает шрифт этого компонента.
`FontMetrics`	`getFontMetrics(Font font)`	Возвращает метрики шрифта для указанного шрифта.
`Color`	`getForeground()`	Возвращает цвет переднего плана этого компонента.
`Graphics`	`getGraphics()`	Создает графический контекст для этого компонента.
`GraphicsConfiguration`	`getGraphicsConfiguration()`	Возвращает `GraphicsConfiguration`, связанный с этим `Component`.
`int`	`getHeight()`	Возвращает текущую высоту этого компонента.
`HierarchyBoundsListener[]`	`getHierarchyBoundsListeners()`	Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
`HierarchyListener[]`	`getHierarchyListeners()`	Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
`boolean`	`getIgnoreRepaint()`	Возвращает признак того, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
`InputContext`	`getInputContext()`	Возвращает контекст ввода, используемый этим компонентом для обработки взаимодействия с методами ввода при вводе текста в этот компонент.
`InputMethodListener[]`	`getInputMethodListeners()`	Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
`InputMethodRequests`	`getInputMethodRequests()`	Возвращает обработчик запросов метода ввода, поддерживающий запросы от методов ввода для этого компонента.
`KeyListener[]`	`getKeyListeners()`	Возвращает массив всех слушателей клавиш, зарегистрированных для этого компонента.
`Locale`	`getLocale()`	Возвращает локаль этого компонента.
`Point`	`getLocation()`	Возвращает положение этого компонента в виде точки, определяющей его левый верхний угол.
`Point`	`getLocation(Point rv)`	Сохраняет начальные координаты x, y этого компонента в «возвращаемое значение» rv и возвращает rv.
`Point`	`getLocationOnScreen()`	Возвращает положение этого компонента в виде точки, определяющей левый верхний угол компонента в пространстве координат экрана.
`MouseListener[]`	`getMouseListeners()`	Возвращает массив всех слушателей мыши, зарегистрированных для этого компонента.
`MouseMotionListener[]`	`getMouseMotionListeners()`	Возвращает массив всех слушателей перемещения мыши, зарегистрированных для этого компонента.
`Point`	`getMousePosition()`	Возвращает положение указателя мыши в пространстве координат этого `Component`, если `Component` находится непосредственно под указателем мыши; в противном случае возвращает `null`.
`MouseWheelListener[]`	`getMouseWheelListeners()`	Возвращает массив всех слушателей колесика мыши, зарегистрированных для этого компонента.
`String`	`getName()`	Возвращает имя компонента.
`Container`	`getParent()`	Возвращает родительский компонент данного компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех слушателей изменений свойств, зарегистрированных для этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)`	Возвращает массив всех слушателей, связанных с указанным свойством.
`Dimension`	`getSize()`	Возвращает размер этого компонента в виде объекта `Dimension`.
`Dimension`	`getSize(Dimension rv)`	Сохраняет ширину и высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
`Toolkit`	`getToolkit()`	Возвращает инструментарий этого компонента.
`final Object`	`getTreeLock()`	Возвращает объект блокировки этого компонента (объект, владеющий монитором синхронизации потоков) для операций с деревом компонентов AWT и разметкой.
`int`	`getWidth()`	Возвращает текущую ширину этого компонента.
`int`	`getX()`	Возвращает текущую координату x начала координат компонента.
`int`	`getY()`	Возвращает текущую координату y начала координат компонента.
`boolean`	`gotFocus(Event evt, Object what)`	Устарело. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
`boolean`	`handleEvent(Event evt)`	Устарело. Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent).
`boolean`	`hasFocus()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`void`	`hide()`	Устарело. Начиная с версии JDK 1.1, заменено на `setVisible(boolean)`.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int w, int h)`	Перерисовывает компонент при изменении изображения.
`boolean`	`inside(int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на contains(int, int).
`boolean`	`isBackgroundSet()`	Возвращает признак того, был ли цвет фона явно установлен для этого Component.
`boolean`	`isCursorSet()`	Возвращает признак того, был ли курсор явно установлен для этого Component.
`boolean`	`isDisplayable()`	Определяет, является ли этот компонент отображаемым.
`boolean`	`isDoubleBuffered()`	Возвращает true, если этот компонент отрисовывается в закадровое изображение («буфер»), которое позже копируется на экран.
`boolean`	`isEnabled()`	Определяет, включен ли этот компонент.
`boolean`	`isFocusable()`	Возвращает признак того, может ли этот Component получать фокус.
`boolean`	`isFocusOwner()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`boolean`	`isFocusTraversable()`	Устарело. Начиная с версии 1.4, заменено на `isFocusable()`.
`boolean`	`isFontSet()`	Возвращает признак того, был ли шрифт явно установлен для этого Component.
`boolean`	`isForegroundSet()`	Возвращает признак того, был ли цвет переднего плана явно установлен для этого Component.
`boolean`	`isLightweight()`	Легковесный компонент не имеет нативного аналога (peer) в инструментарии.
`boolean`	`isMaximumSizeSet()`	Возвращает true, если максимальный размер был установлен в значение, отличное от `null`; в противном случае возвращает false.
`boolean`	`isMinimumSizeSet()`	Возвращает, был ли вызван метод `setMinimumSize` со значением, отличным от null.
`boolean`	`isOpaque()`	Возвращает true, если этот компонент полностью непрозрачен; по умолчанию возвращает false.
`boolean`	`isPreferredSizeSet()`	Возвращает true, если предпочтительный размер был установлен в значение, отличное от `null`; в противном случае возвращает false.
`boolean`	`isShowing()`	Определяет, отображается ли этот компонент на экране.
`boolean`	`isValid()`	Определяет, является ли этот компонент корректным (valid).
`boolean`	`isVisible()`	Определяет, должен ли этот компонент быть видимым, когда видим его родительский компонент.
`boolean`	`keyDown(Event evt, int key)`	Устарело. Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
`boolean`	`keyUp(Event evt, int key)`	Устарело. Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
`void`	`list()`	Выводит список характеристик этого компонента в стандартный системный поток вывода `System.out`.
`void`	`list(PrintStream out)`	Выводит список характеристик этого компонента в указанный поток вывода.
`void`	`list(PrintWriter out)`	Выводит список характеристик в указанный print writer.
`Point`	`location()`	Устарело. Начиная с версии JDK 1.1, заменено на `getLocation()`.
`boolean`	`lostFocus(Event evt, Object what)`	Устарело. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
`boolean`	`mouseDown(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseDrag(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseEnter(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseExit(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseMove(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseUp(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
`void`	`move(int x, int y)`	Устарело. Начиная с версии JDK 1.1, заменено на `setLocation(int, int)`.
`void`	`nextFocus()`	Устарело. Начиная с версии JDK 1.1, заменено на transferFocus().
`void`	`paintAll(Graphics g)`	Отрисовывает этот компонент и все его подкомпоненты.
`boolean`	`postEvent(Event e)`	Устарело. Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent).
`prepareImage(Image image, int width, int height, ImageObserver observer)`	`boolean`	Подготавливает изображение для отображения на этом компоненте с указанной шириной и высотой.
`boolean`	`prepareImage(Image image, ImageObserver observer)`	Подготавливает изображение для отображения на этом компоненте.
`void`	`printAll(Graphics g)`	Печатает этот компонент и все его подкомпоненты.
`protected void`	`processComponentEvent(ComponentEvent e)`	Обрабатывает события компонента, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам `ComponentListener`.
`protected void`	`processFocusEvent(FocusEvent e)`	Обрабатывает события фокуса, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам `FocusListener`.
`protected void`	`processHierarchyBoundsEvent(HierarchyEvent e)`	Обрабатывает события границ иерархии, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам `HierarchyBoundsListener`.
`protected void`	`processHierarchyEvent(HierarchyEvent e)`	Обрабатывает события иерархии, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам `HierarchyListener`.
`protected void`	`processInputMethodEvent(InputMethodEvent e)`	Обрабатывает события метода ввода, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам `InputMethodListener`.
`protected void`	`processKeyEvent(KeyEvent e)`	Обрабатывает события клавиш, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам `KeyListener`.
`protected void`	`processMouseEvent(MouseEvent e)`	Обрабатывает события мыши, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам `MouseListener`.
`protected void`	`processMouseMotionEvent(MouseEvent e)`	Обрабатывает события перемещения мыши, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам `MouseMotionListener`.
`protected void`	`processMouseWheelEvent(MouseWheelEvent e)`	Обрабатывает события колесика мыши, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам `MouseWheelListener`.
`void`	`remove(MenuComponent popup)`	Удаляет указанное всплывающее меню из компонента.
`void`	`removeComponentListener(ComponentListener l)`	Удаляет указанный слушатель компонентов, чтобы он больше не получал события компонента от этого компонента.
`void`	`removeFocusListener(FocusListener l)`	Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`removeHierarchyBoundsListener(HierarchyBoundsListener l)`	Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
`void`	`removeHierarchyListener(HierarchyListener l)`	Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
`void`	`removeInputMethodListener(InputMethodListener l)`	Удаляет указанный слушатель методов ввода, чтобы он больше не получал события метода ввода от этого компонента.
`void`	`removeKeyListener(KeyListener l)`	Удаляет указанный слушатель клавиш, чтобы он больше не получал события клавиатуры от этого компонента.
`void`	`removeMouseListener(MouseListener l)`	Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента.
`void`	`removeMouseMotionListener(MouseMotionListener l)`	Удаляет указанный слушатель перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента.
`void`	`removeMouseWheelListener(MouseWheelListener l)`	Удаляет указанный слушатель колесика мыши, чтобы он больше не получал события колесика мыши от этого компонента.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка слушателей.
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Удаляет `PropertyChangeListener` из списка слушателей для указанного свойства.

`void`	`repaint()`	Перерисовывает этот компонент.
`void`	`repaint(int x, int y, int width, int height)`	Перерисовывает указанную прямоугольную область этого компонента.
`void`	`repaint(long tm)`	Перерисовывает компонент.
`void`	`repaint(long tm, int x, int y, int width, int height)`	Перерисовывает указанную прямоугольную область этого компонента в течение `tm` миллисекунд.
`void`	`requestFocus()`	Запрашивает передачу фокуса ввода этому Component, а также чтобы предок верхнего уровня этого Component стал активным Window.
`protected boolean`	`requestFocus(boolean temporary)`	Запрашивает передачу фокуса ввода этому `Component`, а также чтобы предок верхнего уровня этого `Component` стал активным `Window`.
`protected boolean`	`requestFocus(boolean temporary, FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому `Component`, а также чтобы предок верхнего уровня этого `Component` стал активным `Window`.
`void`	`requestFocus(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому Component, а также чтобы предок верхнего уровня этого Component стал активным Window.
`boolean`	`requestFocusInWindow()`	Запрашивает передачу фокуса ввода этому Component, если предок верхнего уровня этого Component уже является активным Window.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Запрашивает передачу фокуса ввода этому `Component`, если предок верхнего уровня этого `Component` уже является активным `Window`.
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому Component, если предок верхнего уровня этого Component уже является активным Window.
`void`	`reshape(int x, int y, int width, int height)`	Устарело. Начиная с версии JDK 1.1, заменено на `setBounds(int, int, int, int)`.
`void`	`resize(int width, int height)`	Устарело. Начиная с версии JDK 1.1, заменено на `setSize(int, int)`.
`void`	`resize(Dimension d)`	Устарело. Начиная с версии JDK 1.1, заменено на `setSize(Dimension)`.
`void`	`revalidate()`	Повторно проверяет и обновляет (revalidates) иерархию компонентов вплоть до ближайшего корня валидации.
`void`	`setBackground(Color c)`	Задает цвет фона этого компонента.
`void`	`setBounds(int x, int y, int width, int height)`	Перемещает этот компонент и изменяет его размер.
`void`	`setBounds(Rectangle r)`	Перемещает этот компонент и изменяет его размер в соответствии с новым ограничивающим прямоугольником `r`.
`void`	`setComponentOrientation(ComponentOrientation o)`	Задает ориентацию с учетом языка, которая будет использоваться для упорядочивания элементов или текста внутри этого компонента.
`void`	`setCursor(Cursor cursor)`	Устанавливает изображение курсора на указанный курсор.
`void`	`setDropTarget(DropTarget dt)`	Связывает `DropTarget` с этим компонентом.
`void`	`setEnabled(boolean b)`	Включает или отключает этот компонент в зависимости от значения параметра `b`.
`void`	`setFocusable(boolean focusable)`	Задает состояние фокусируемости этого Component в указанное значение.
`void`	`setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)`	Определяет, включены ли клавиши перемещения фокуса для этого Component.
`void`	`setForeground(Color c)`	Задает цвет переднего плана этого компонента.
`void`	`setIgnoreRepaint(boolean ignoreRepaint)`	Определяет, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
`void`	`setLocale(Locale l)`	Задает локаль этого компонента.
`void`	`setLocation(int x, int y)`	Перемещает этот компонент на новую позицию.
`void`	`setLocation(Point p)`	Перемещает этот компонент на новую позицию.
`void`	`setMaximumSize(Dimension maximumSize)`	Устанавливает максимальный размер этого компонента в постоянное значение.
`void`	`setMinimumSize(Dimension minimumSize)`	Устанавливает минимальный размер этого компонента в постоянное значение.
`void`	`setMixingCutoutShape(Shape shape)`	Задает форму 'mixing-cutout' для этого легковесного компонента.
`void`	`setName(String name)`	Задает имя компонента в указанную строку.
`void`	`setPreferredSize(Dimension preferredSize)`	Устанавливает предпочтительный размер этого компонента в постоянное значение.
`void`	`setSize(int width, int height)`	Изменяет размер этого компонента так, чтобы он имел ширину `width` и высоту `height`.
`void`	`setSize(Dimension d)`	Изменяет размер этого компонента так, чтобы он имел ширину `d.width` и высоту `d.height`.
`void`	`setVisible(boolean b)`	Показывает или скрывает этот компонент в зависимости от значения параметра `b`.
`void`	`show()`	Устарело. Начиная с версии JDK 1.1, заменено на `setVisible(boolean)`.
`void`	`show(boolean b)`	Устарело. Начиная с версии JDK 1.1, заменено на `setVisible(boolean)`.
`Dimension`	`size()`	Устарело. Начиная с версии JDK 1.1, заменено на `getSize()`.
`String`	`toString()`	Возвращает строковое представление этого компонента и его значений.
`void`	`transferFocus()`	Передает фокус следующему компоненту так, как если бы этот Component являлся владельцем фокуса.
`void`	`transferFocusBackward()`	Передает фокус предыдущему компоненту так, как если бы этот Component являлся владельцем фокуса.
`void`	`transferFocusUpCycle()`	Передает фокус на один цикл обхода фокуса вверх.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, "равен" ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, для удаления: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в будущей версии.
`final Class<?>`	`getClass()`	Возвращает класс среды выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Приводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством оповещения (notified) или прерывания (interrupted).
`final void`	`wait(long timeoutMillis)`	Приводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством оповещения (notified) или прерывания (interrupted), либо до истечения определенного времени реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством оповещения (notified) или прерывания (interrupted), либо до истечения определенного времени реального времени.

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

Container

public Container()

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

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

getComponentCount

public int getComponentCount()

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

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

Returns:

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

Since:

1.1

See Also:

countComponents

@Deprecated public int countComponents()

Устарело.

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

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

Returns:: количество компонентов в этом контейнере

getComponent

public Component getComponent(int n)

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

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

Parameters:

n - индекс получаемого компонента.

Returns:

n-й компонент в этом контейнере.

Throws:

ArrayIndexOutOfBoundsException - если n-е значение не существует.

See Also:

getComponents

public Component[] getComponents()

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

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

Returns:

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

See Also:

getInsets

public Insets getInsets()

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

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

Returns:

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

Since:

1.1

See Also:

insets

@Deprecated public Insets insets()

Устарело.

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

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

Returns:: внутренние отступы для этого контейнера

add

public Component add(Component comp)

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

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

Parameters:

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

Returns:

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

Throws:

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

See Also:

add

public Component add(String name, Component comp)

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

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

Parameters:

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

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

Returns:

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

Throws:

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

See Also:

add

public Component add(Component comp, int index)

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

Parameters:

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

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

Returns:

компонент comp

Throws:

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

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

See Also:

setComponentZOrder

public void setComponentZOrder(Component comp, int index)

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

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

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

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

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

Parameters:

comp - перемещаемый компонент

index - позиция в списке контейнера для вставки компонента, где getComponentCount() добавляет в конец

Throws:

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

IllegalArgumentException - если comp является одним из предков контейнера

IllegalArgumentException - если index не входит в диапазон [0, getComponentCount()] при перемещении между контейнерами или не входит в диапазон [0, getComponentCount()-1] при перемещении внутри контейнера

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

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

Since:

1.5

See Also:

getComponentZOrder

public int getComponentZOrder(Component comp)

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

Parameters:

comp - запрашиваемый компонент

Returns:

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

Since:

1.5

See Also:

add

public void add(Component comp, Object constraints)

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

Parameters:

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

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

Throws:

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

Since:

1.1

See Also:

add

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

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

Parameters:

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

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

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

Throws:

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

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

See Also:

addImpl

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

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

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

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

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

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

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

super.addImpl(comp, constraints, index)

Parameters:

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

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

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

Throws:

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

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

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

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

Since:

1.1

See Also:

remove

public void remove(int index)

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

Parameters:

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

Throws:

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

Since:

1.1

See Also:

remove

public void remove(Component comp)

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

Parameters:

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

Throws:

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

See Also:

removeAll

public void removeAll()

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

See Also:

getLayout

public LayoutManager getLayout()

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

Returns:

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

See Also:

setLayout

public void setLayout(LayoutManager mgr)

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

Parameters:

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

See Also:

doLayout

public void doLayout()

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

Overrides:

doLayout в классе Component

Since:

1.1

See Also:

layout

@Deprecated public void layout()

Устарело.

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

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

isValidateRoot

public boolean isValidateRoot()

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

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

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

Класс Window является корнем валидации в AWT. Swing вводит дополнительные корни валидации.

Returns:

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

Since:

1.7

See Also:

invalidate

public void invalidate()

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

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

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

Overrides:

invalidate в классе Component

See Also:

validate

public void validate()

Выполняет валидацию этого контейнера и всех его подкомпонентов.

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

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

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

Overrides:

validate в классе Component

See Also:

validateTree

protected void validateTree()

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

See Also:

setFont

public void setFont(Font f)

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

Overrides:

setFont в классе Component

Parameters:

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

Since:

1.0

See Also:

getPreferredSize

public Dimension getPreferredSize()

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

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

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

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) и LayoutManager, установленный для этого Container, является экземпляром 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 суперкласса.

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

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

processEvent в классе Component

Параметры:

e - событие

См. также:

processContainerEvent

protected void processContainerEvent(ContainerEvent e)

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

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

Параметры:

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. В случае перекрытия компонентов возвращается самый верхний дочерний компонент. Это определяется поиском компонента, ближайшего к индексу 0, который подтверждает содержание заданной точки через 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, этот метод вернет значение, отличное от null, только если указатель мыши находится непосредственно над Container, а не над частью, закрытой дочерними элементами. Если allowChildren имеет значение true, этот метод возвращает значение, отличное от null, если указатель мыши находится над 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)

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

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

list в классе Component

Параметры:

out - объект print writer

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

Бросает:

NullPointerException - если out имеет значение null

С версии:

1.1

См. также:

setFocusTraversalKeys

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

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

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

Рекомендуемые значения по умолчанию для клавиш перемещения фокуса Container
Идентификатор	Значение	По умолчанию
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, будут поглощены и не будут отправлены ни в один Container. Указание события KEY_TYPED для сопоставления с операцией перемещения фокуса или сопоставление одного и того же события с несколькими операциями перемещения фокуса по умолчанию является ошибкой времени выполнения.

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

Начиная с:

1.4

См. также:

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

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

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

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

getFocusTraversalKeys в классе Component

Параметры:

Возвращает:

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

Исключения:

Начиная с:

1.4

См. также:

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

Возвращает, был ли явно определен Set клавиш перемещения фокуса для данной операции перемещения фокуса для этого Container. Если этот метод возвращает false, этот Container наследует 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 клавиш перемещения фокуса для данной операции перемещения фокуса был явно определен для этого Component; 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)

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

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

isFocusCycleRoot в классе Component

Параметры:

container — проверяемый Container

Возвращает:

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

Начиная с:

1.4

См. также:

setFocusTraversalPolicy

public void setFocusTraversalPolicy(FocusTraversalPolicy policy)

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

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

Параметры:

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

Начиная с:

1.4

См. также:

getFocusTraversalPolicy

public FocusTraversalPolicy getFocusTraversalPolicy()

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

Возвращает:

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

Начиная с:

1.4

См. также:

isFocusTraversalPolicySet

public boolean isFocusTraversalPolicySet()

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

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

setFocusCycleRoot

public void setFocusCycleRoot(boolean focusCycleRoot)

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

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

Параметры:

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

Начиная с:

1.4

См. также:

isFocusCycleRoot

public boolean isFocusCycleRoot()

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

Возвращает:

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

Начиная с:

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

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

Начиная с:

1.4

См. также:

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation o)

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

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

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

applyComponentOrientation в классе Component

Параметры:

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

Исключения:

NullPointerException — если orientation имеет значение null.

Начиная с:

1.4

См. также:

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

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

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

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

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

addPropertyChangeListener в классе Component

Параметры:

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

См. также:

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

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

шрифт этого Container ("font")
цвет фона этого Container ("background")
цвет текста этого Container ("foreground")
возможность фокусировки этого Container ("focusable")
состояние включения клавиш перемещения фокуса этого Container ("focusTraversalKeysEnabled")
набор FORWARD_TRAVERSAL_KEYS этого Container ("forwardFocusTraversalKeys")
набор BACKWARD_TRAVERSAL_KEYS этого Container ("backwardFocusTraversalKeys")
набор UP_CYCLE_TRAVERSAL_KEYS этого Container ("upCycleFocusTraversalKeys")
набор DOWN_CYCLE_TRAVERSAL_KEYS этого Container ("downCycleFocusTraversalKeys")
политика перемещения фокуса этого Container ("focusTraversalPolicy")
состояние корня цикла фокуса этого Container ("focusCycleRoot")
состояние поставщика политики перемещения фокуса этого Container ("focusTraversalPolicyProvider")
состояние поставщика политики перемещения фокуса этого Container ("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.