Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Container extends Component
Компоненты, добавленные к контейнеру, прослеживаются в списке. Порядок списка определит порядок укладки компонентов грудь-спина в пределах контейнера. Если никакой индекс не будет определен, добавляя компонент к контейнеру, то это будет добавлено до конца списка (и следовательно к нижней части порядка укладки).
Отметьте: Для получения дополнительной информации на подсистеме фокуса, см.
add(java.awt.Component, int)
, getComponent(int)
, LayoutManager
, Сериализированная ФормаМодификатор и Тип | Класс и Описание |
---|---|
protected class |
Контейнер. AccessibleAWTContainer
Внутренний класс Контейнера, используемого, чтобы оказать поддержку по умолчанию для доступности.
|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Конструктор и Описание |
---|
Container()
Создает новый Контейнер.
|
Модификатор и Тип | Метод и Описание |
---|---|
Компонент |
add(Component comp)
Добавляет указанный компонент до конца этого контейнера.
|
Компонент |
add(Component comp, int index)
Добавляет указанный компонент к этому контейнеру в данной позиции.
|
void |
add(Component comp, Object constraints)
Добавляет указанный компонент до конца этого контейнера.
|
void |
add(Component comp, Object constraints, int index)
Добавляет указанный компонент к этому контейнеру с указанными ограничениями по указанному индексу.
|
Компонент |
add(String name, Component comp)
Добавляет указанный компонент к этому контейнеру.
|
void |
addContainerListener(ContainerListener l)
Добавляет указанный контейнерный слушатель, чтобы получить контейнерные события от этого контейнера.
|
protected void |
addImpl(Component comp, Object constraints, int index)
Добавляет указанный компонент к этому контейнеру по указанному индексу.
|
void |
addNotify()
Делает этот Контейнер визуализуемым, соединяя это с собственным экранным ресурсом.
|
void |
addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener к списку слушателя.
|
void |
addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener к списку слушателя для определенного свойства.
|
void |
applyComponentOrientation(ComponentOrientation o)
Наборы
ComponentOrientation свойство этого контейнера и всех компонентов содержится в пределах этого. |
boolean |
areFocusTraversalKeysSet(int id)
Возвраты, был ли Набор ключей обхода фокуса для данной работы обхода фокуса явно определен для этого Контейнера.
|
int |
countComponents()
Осуждаемый.
С версии 1.1 JDK, замененной getComponentCount ().
|
void |
deliverEvent(Event e)
Осуждаемый.
С версии 1.1 JDK, замененной
dispatchEvent(AWTEvent e) |
void |
doLayout()
Причины этот контейнер, чтобы разметить его компоненты.
|
Компонент |
findComponentAt(int x, int y)
Определяет местоположение видимого дочернего компонента, который содержит указанную позицию.
|
Компонент |
findComponentAt(Point p)
Определяет местоположение видимого дочернего компонента, который содержит указанную точку.
|
float |
getAlignmentX()
Возвращает выравнивание вдоль оси X.
|
float |
getAlignmentY()
Возвращает выравнивание вдоль оси Y.
|
Компонент |
getComponent(int n)
Получает энный компонент в этом контейнере.
|
Компонент |
getComponentAt(int x, int y)
Определяет местоположение компонента, который содержит x, y позиция.
|
Компонент |
getComponentAt(Point p)
Получает компонент, который содержит указанную точку.
|
int |
getComponentCount()
Получает число компонентов в этой панели.
|
Компонент[] |
getComponents()
Получает все компоненты в этом контейнере.
|
int |
getComponentZOrder(Component comp)
Возвращает индекс z-порядка компонента в контейнере.
|
ContainerListener[] |
getContainerListeners()
Возвращает массив всех контейнерных слушателей, зарегистрированных на этом контейнере.
|
Set<AWTKeyStroke> |
getFocusTraversalKeys(int id)
Возвращает Набор ключей обхода фокуса для данной работы обхода для этого Контейнера.
|
FocusTraversalPolicy |
getFocusTraversalPolicy()
Возвращает политику обхода фокуса, которая будет управлять обходом клавиатуры дочерних элементов этого Контейнера, или нулем, если этот Контейнер не будет корнем цикла фокуса.
|
Вставки |
getInsets()
Определяет вставки этого контейнера, которые указывают на размер границы контейнера.
|
LayoutManager |
getLayout()
Получает менеджера по расположению по этому контейнеру.
|
<T extends EventListener> |
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, в настоящий момент зарегистрированных как
FooListener s на это Container . |
Размерность |
getMaximumSize()
Возвращает максимальный размер этого контейнера.
|
Размерность |
getMinimumSize()
Возвращает минимальный размер этого контейнера.
|
Точка |
getMousePosition(boolean allowChildren)
Возвращает позицию указателя мыши в этом
Container 's координатное пространство, если Container находится под указателем мыши, иначе возвраты null . |
Размерность |
getPreferredSize()
Возвращает привилегированный размер этого контейнера.
|
Вставки |
insets()
Осуждаемый.
С версии 1.1 JDK, замененной
getInsets() . |
void |
invalidate()
Лишает законной силы контейнер.
|
boolean |
isAncestorOf(Component c)
Проверки, если компонент содержится в иерархии компонентов этого контейнера.
|
boolean |
isFocusCycleRoot()
Возвраты, является ли этот Контейнер корнем цикла обхода фокуса.
|
boolean |
isFocusCycleRoot(Container container)
Возвраты, является ли указанный Контейнер корнем цикла фокуса цикла обхода фокуса этого Контейнера.
|
boolean |
isFocusTraversalPolicyProvider()
Возвраты, обеспечивает ли этот контейнер политику обхода фокуса.
|
boolean |
isFocusTraversalPolicySet()
Возвраты, была ли политика обхода фокуса явно установлена для этого Контейнера.
|
boolean |
isValidateRoot()
Указывает, является ли этот контейнер проверить корнем.
|
void |
layout()
Осуждаемый.
С версии 1.1 JDK, замененной
doLayout() . |
void |
list(PrintStream out, int indent)
Печатает перечисление этого контейнера к указанному потоку вывода.
|
void |
list(PrintWriter out, int indent)
Распечатывает список, запускающийся в указанном добавлении отступа, указанному писателю печати.
|
Компонент |
locate(int x, int y)
Осуждаемый.
С версии 1.1 JDK, замененной
getComponentAt(int, int) . |
Размерность |
minimumSize()
Осуждаемый.
С версии 1.1 JDK, замененной
getMinimumSize() . |
void |
paint(Graphics g)
Красит контейнер.
|
void |
paintComponents(Graphics g)
Краски каждый из компонентов в этом контейнере.
|
protected String |
paramString()
Возвращает строку, представляющую состояние этого
Container . |
Размерность |
preferredSize()
Осуждаемый.
С версии 1.1 JDK, замененной
getPreferredSize() . |
void |
print(Graphics g)
Печатает контейнер.
|
void |
printComponents(Graphics g)
Печатные издания каждый из компонентов в этом контейнере.
|
protected void |
processContainerEvent(ContainerEvent e)
События контейнера процессов, происходящие на этом контейнере, диспетчеризируя их любому, зарегистрировали объекты ContainerListener.
|
protected void |
processEvent(AWTEvent e)
События процессов на этом контейнере.
|
void |
remove(Component comp)
Удаляет указанный компонент из этого контейнера.
|
void |
remove(int index)
Удаляет компонент, определенный
index , от этого контейнера. |
void |
removeAll()
Удаляет все компоненты из этого контейнера.
|
void |
removeContainerListener(ContainerListener l)
Удаляет указанного контейнерного слушателя, таким образом, это больше не получает контейнерные события от этого контейнера.
|
void |
removeNotify()
Делает этот Контейнер невизуализуемым, удаляя его соединение с его собственным экранным ресурсом.
|
void |
setComponentZOrder(Component comp, int index)
Перемещает указанный компонент в указанный индекс z-порядка в контейнере.
|
void |
setFocusCycleRoot(boolean focusCycleRoot)
Наборы, является ли этот Контейнер корнем цикла обхода фокуса.
|
void |
setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Устанавливает ключи обхода фокуса для данной работы обхода для этого Контейнера.
|
void |
setFocusTraversalPolicy(FocusTraversalPolicy policy)
Устанавливает политику обхода фокуса, которая будет управлять обходом клавиатуры дочерних элементов этого Контейнера, если этот Контейнер будет корнем цикла фокуса.
|
void |
setFocusTraversalPolicyProvider(boolean provider)
Наборы, будет ли этот контейнер использоваться, чтобы обеспечить политику обхода фокуса.
|
void |
setFont(Font f)
Устанавливает шрифт этого контейнера.
|
void |
setLayout(LayoutManager mgr)
Устанавливает менеджера по расположению по этому контейнеру.
|
void |
transferFocusDownCycle()
Передает фокус вниз один цикл обхода фокуса.
|
void |
update(Graphics g)
Обновляет контейнер.
|
void |
validate()
Проверяет этого контейнера и всех его субкомпонентов.
|
protected void |
validateTree()
Рекурсивно убывает контейнерное дерево и повторно вычисляет расположение для любых поддеревьев, отмеченных как необходимость в этом (отмеченные как недопустимое).
|
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
public Container()
public int getComponentCount()
Отметьте: Этот метод нужно вызвать под древовидной блокировкой AWT.
getComponent(int)
, Component.getTreeLock()
@Deprecated public int countComponents()
public Component getComponent(int n)
Отметьте: Этот метод нужно вызвать под древовидной блокировкой AWT.
n
- индекс компонента, чтобы добраться.ArrayIndexOutOfBoundsException
- если энное значение не существует.Component.getTreeLock()
public Component[] getComponents()
Отметьте: Этот метод нужно вызвать под древовидной блокировкой AWT.
Component.getTreeLock()
public Insets getInsets()
A Frame
у объекта, например, есть главная вставка, которая соответствует высоте строки заголовка фрейма.
Insets
, LayoutManager
@Deprecated public Insets insets()
getInsets()
.public Component add(Component comp)
addImpl(java.awt.Component, java.lang.Object, int)
. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов. Если контейнер был уже выведен на экран, иерархия должна быть проверена после того, чтобы вывести на экран добавленный компонент.
comp
- компонент, который будет добавленNullPointerException
- если comp
null
addImpl(java.awt.Component, java.lang.Object, int)
, invalidate()
, validate()
, JComponent.revalidate()
public Component add(String name, Component comp)
addImpl(java.awt.Component, java.lang.Object, int)
. Этот метод является устаревшим с 1.1. Пожалуйста, используйте метод add(Component, Object)
вместо этого.
Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов. Если контейнер был уже выведен на экран, иерархия должна быть проверена после того, чтобы вывести на экран добавленный компонент.
NullPointerException
- если comp
null
add(Component, Object)
, invalidate()
public Component add(Component comp, int index)
addImpl(java.awt.Component, java.lang.Object, int)
. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов. Если контейнер был уже выведен на экран, иерархия должна быть проверена после того, чтобы вывести на экран добавленный компонент.
comp
- компонент, который будет добавленindex
- позиция, в которой можно вставить компонент, или -1
добавлять компонент до концаcomp
NullPointerException
- если comp
null
IllegalArgumentException
- если index
недопустимо (см. addImpl(java.awt.Component, java.lang.Object, int)
для деталей)addImpl(java.awt.Component, java.lang.Object, int)
, remove(int)
, invalidate()
, validate()
, JComponent.revalidate()
public void setComponentZOrder(Component comp, int index)
Если компонент является дочерним элементом некоторого другого контейнера, он удаляется из того контейнера прежде, чем быть добавленным к этому контейнеру. Важное различие между этим методом и 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
- добавляя a Window
к контейнеруgetComponentZOrder(java.awt.Component)
, invalidate()
public int getComponentZOrder(Component comp)
comp
- запрашиваемый компонентnull
или не принадлежит контейнеруsetComponentZOrder(java.awt.Component, int)
public void add(Component comp, Object constraints)
addImpl(java.awt.Component, java.lang.Object, int)
. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов. Если контейнер был уже выведен на экран, иерархия должна быть проверена после того, чтобы вывести на экран добавленный компонент.
comp
- компонент, который будет добавленconstraints
- расположение выражения объекта contraints для этого компонентаNullPointerException
- если comp
null
addImpl(java.awt.Component, java.lang.Object, int)
, invalidate()
, validate()
, JComponent.revalidate()
, LayoutManager
public void add(Component comp, Object constraints, int index)
addImpl(java.awt.Component, java.lang.Object, int)
. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов. Если контейнер был уже выведен на экран, иерархия должна быть проверена после того, чтобы вывести на экран добавленный компонент.
comp
- компонент, который будет добавленconstraints
- расположение выражения объекта contraints для этогоindex
- позиция в списке контейнера, в котором можно вставить компонент; -1
средства вставляют в компоненте концаNullPointerException
- если comp
null
IllegalArgumentException
- если index
недопустимо (см. addImpl(java.awt.Component, java.lang.Object, int)
для деталей)addImpl(java.awt.Component, java.lang.Object, int)
, invalidate()
, validate()
, JComponent.revalidate()
, remove(int)
, LayoutManager
protected void addImpl(Component comp, Object constraints, int index)
addLayoutComponent
метод. Ограничения определяются определенным используемым менеджером по расположению. Например, BorderLayout
класс определяет пять ограничений: BorderLayout.NORTH
, BorderLayout.SOUTH
, BorderLayout.EAST
, BorderLayout.WEST
, и BorderLayout.CENTER
.
GridBagLayout
класс требует a GridBagConstraints
объект. Отказ передать корректный тип ограничений возражает результатам в IllegalArgumentException
.
Если текущий менеджер по расположению реализует LayoutManager2
, тогда LayoutManager2.addLayoutComponent(Component,Object)
вызывается на это. Если текущий менеджер по расположению не реализует LayoutManager2
, и ограничения являются a 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
add(Component)
, add(Component, int)
, add(Component, java.lang.Object)
, invalidate()
, LayoutManager
, LayoutManager2
public void remove(int index)
index
, от этого контейнера. Этот метод также уведомляет менеджера по расположению, чтобы удалить компонент из расположения этого контейнера через removeLayoutComponent
метод. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов. Если контейнер был уже выведен на экран, иерархия должна быть проверена после того, чтобы отразить изменения.
index
- индекс компонента, который будет удаленArrayIndexOutOfBoundsException
- если index
не находится в диапазоне [0, getComponentCount()-1]
add(java.awt.Component)
, invalidate()
, validate()
, getComponentCount()
public void remove(Component comp)
removeLayoutComponent
метод. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов. Если контейнер был уже выведен на экран, иерархия должна быть проверена после того, чтобы отразить изменения.
comp
- компонент, который будет удаленNullPointerException
- если comp
null
add(java.awt.Component)
, invalidate()
, validate()
, remove(int)
public void removeAll()
removeLayoutComponent
метод. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов. Если контейнер был уже выведен на экран, иерархия должна быть проверена после того, чтобы отразить изменения.
add(java.awt.Component)
, remove(int)
, invalidate()
public LayoutManager getLayout()
doLayout()
, setLayout(java.awt.LayoutManager)
public void setLayout(LayoutManager mgr)
Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.
mgr
- указанный менеджер по расположениюdoLayout()
, getLayout()
, invalidate()
public void doLayout()
validate
метод вместо этого.doLayout
в классе Component
LayoutManager.layoutContainer(java.awt.Container)
, setLayout(java.awt.LayoutManager)
, validate()
@Deprecated public void layout()
doLayout()
.public boolean isValidateRoot()
Связанные с расположением изменения, такие как границы проверить корневых потомков, не влияют на расположение проверить корневого родителя. Эта особенность включает invalidate()
метод, чтобы прекратить лишать законной силы иерархию компонентов, когда метод встречается с проверить корнем. Однако, чтобы сохранить обратную совместимость это новое оптимизированное поведение включается только когда java.awt.smartInvalidate
системное значение свойства устанавливается в true
.
Если иерархия компонентов содержит, проверяют корней и оптимизированного нового invalidate()
поведение включается, validate()
метод должен быть вызван на проверить корень ранее лишенного законной силы компонента, чтобы восстановить законность иерархии позже. Иначе, вызов validate()
метод на высокоуровневом контейнере (таком как a Frame
объект), должен использоваться, чтобы восстановить законность иерархии компонентов.
Window
класс и Applet
класс является проверить корнями в AWT. Swing представляет, больше проверяют корней.
invalidate()
, Component.invalidate()
, JComponent.isValidateRoot()
, JComponent.revalidate()
public void invalidate()
Если LayoutManager
установленный на этом контейнере экземпляр LayoutManager2
интерфейс, тогда LayoutManager2.invalidateLayout(Container)
метод вызывается на это предоставляющий это Container
как параметр.
Впоследствии этот метод отмечает этот недопустимый контейнер, и лишает законной силы его предков. См. Component.invalidate()
метод для большего количества деталей.
invalidate
в классе Component
validate()
, layout()
, LayoutManager2
public void validate()
Проверка допустимости контейнера означает размечать свои субкомпоненты. Связанные с расположением изменения, такие как установка границ компонента, или добавления компонента к контейнеру, лишают законной силы контейнер автоматически. Отметьте, что предки контейнера могут быть лишены законной силы также (см. Component.invalidate()
для деталей.) Поэтому, чтобы восстановить законность иерархии, validate()
метод должен быть вызван на самый верхний недопустимый контейнер иерархии.
Проверка допустимости контейнера может быть довольно отнимающей много времени работой. По причинам производительности разработчик может отложить проверку допустимости иерархии, пока ряд связанных с расположением операций не завершается, например, после добавления всех дочерних элементов к контейнеру.
Если это Container
не допустимо, этот метод вызывает validateTree
метод и метки это Container
как допустимый. Иначе, никакое действие не выполняется.
validate
в классе Component
add(java.awt.Component)
, invalidate()
, isValidateRoot()
, JComponent.revalidate()
, validateTree()
protected void validateTree()
validate
.doLayout()
, validate()
public void setFont(Font f)
Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.
setFont
в классе Component
f
- Шрифт, чтобы стать шрифтом этого контейнера.Component.getFont()
, invalidate()
public Dimension getPreferredSize()
Component.setPreferredSize(Dimension)
и это Container
имеет a non-null
LayoutManager
, тогда LayoutManager.preferredLayoutSize(Container)
используется, чтобы вычислить привилегированный размер. Отметьте: некоторые реализации могут кэшировать значение, возвращенное из LayoutManager
. Реализации, которые не должен вызвать кэш preferredLayoutSize
на LayoutManager
каждый раз этот метод вызывается, скорее LayoutManager
будет только запрошен после Container
становится недопустимым.
getPreferredSize
в классе Component
Dimension
это представляет привилегированный размер этого контейнера.getMinimumSize()
, getMaximumSize()
, getLayout()
, LayoutManager.preferredLayoutSize(Container)
, Component.getPreferredSize()
@Deprecated public Dimension preferredSize()
getPreferredSize()
.preferredSize
в классе Component
public Dimension getMinimumSize()
Component.setMinimumSize(Dimension)
и это Container
имеет a non-null
LayoutManager
, тогда LayoutManager.minimumLayoutSize(Container)
используется, чтобы вычислить минимальный размер. Отметьте: некоторые реализации могут кэшировать значение, возвращенное из LayoutManager
. Реализации, которые не должен вызвать кэш minimumLayoutSize
на LayoutManager
каждый раз этот метод вызывается, скорее LayoutManager
будет только запрошен после Container
становится недопустимым.
getMinimumSize
в классе Component
Dimension
это представляет минимальный размер этого контейнера.getPreferredSize()
, getMaximumSize()
, getLayout()
, LayoutManager.minimumLayoutSize(Container)
, Component.getMinimumSize()
@Deprecated public Dimension minimumSize()
getMinimumSize()
.minimumSize
в классе Component
public Dimension getMaximumSize()
Component.setMaximumSize(Dimension)
и LayoutManager
установленный на этом Container
экземпляр LayoutManager2
, тогда LayoutManager2.maximumLayoutSize(Container)
используется, чтобы вычислить максимальный размер. Отметьте: некоторые реализации могут кэшировать значение, возвращенное из LayoutManager2
. Реализации, которые не должен вызвать кэш maximumLayoutSize
на LayoutManager2
каждый раз этот метод вызывается, скорее LayoutManager2
будет только запрошен после Container
становится недопустимым.
getMaximumSize
в классе Component
Dimension
это представляет максимальный размер этого контейнера.getPreferredSize()
, getMinimumSize()
, getLayout()
, LayoutManager2.maximumLayoutSize(Container)
, Component.getMaximumSize()
public float getAlignmentX()
getAlignmentX
в классе Component
public float getAlignmentY()
getAlignmentY
в классе Component
public void paint(Graphics g)
paint
в классе Component
g
- указанное Графическое окноComponent.update(Graphics)
public void update(Graphics g)
update
в классе Component
g
- указанное Графическое окноComponent.update(Graphics)
public void print(Graphics g)
print
в классе Component
g
- указанное Графическое окноComponent.update(Graphics)
public void paintComponents(Graphics g)
g
- графический контекст.Component.paint(java.awt.Graphics)
, Component.paintAll(java.awt.Graphics)
public void printComponents(Graphics g)
g
- графический контекст.Component.print(java.awt.Graphics)
, Component.printAll(java.awt.Graphics)
public void addContainerListener(ContainerListener l)
Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l
- контейнерный слушательremoveContainerListener(java.awt.event.ContainerListener)
, getContainerListeners()
public void removeContainerListener(ContainerListener l)
Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l
- контейнерный слушательaddContainerListener(java.awt.event.ContainerListener)
, getContainerListeners()
public ContainerListener[] getContainerListeners()
ContainerListener
s или пустой массив, если никакие контейнерные слушатели в настоящий момент не регистрируютсяaddContainerListener(java.awt.event.ContainerListener)
, removeContainerListener(java.awt.event.ContainerListener)
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
FooListener
s на это Container
. FooListener
s регистрируются, используя addFooListener
метод. Можно определить listenerType
параметр с литералом класса, такой как FooListener.class
. Например, можно запросить a Container
c
для его контейнерных слушателей со следующим кодом:
ContainerListener[] cls = (ContainerListener[])(c.getListeners(ContainerListener.class));Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.
getListeners
в классе Component
listenerType
- тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener
FooListener
s на этом контейнере, или пустом массиве, если никакие такие слушатели не были добавленыClassCastException
- если listenerType
не определяет класс или интерфейс, который реализует java.util.EventListener
NullPointerException
- если listenerType
null
getContainerListeners()
protected void processEvent(AWTEvent e)
ContainerEvent
, это вызывает processContainerEvent
метод, еще это вызывает свой суперкласс processEvent
. Отметьте это, если параметр события null
поведение является неуказанным и может привести к исключению.
processEvent
в классе Component
e
- событиеComponent.processComponentEvent(java.awt.event.ComponentEvent)
, Component.processFocusEvent(java.awt.event.FocusEvent)
, Component.processKeyEvent(java.awt.event.KeyEvent)
, Component.processMouseEvent(java.awt.event.MouseEvent)
, Component.processMouseMotionEvent(java.awt.event.MouseEvent)
, Component.processInputMethodEvent(java.awt.event.InputMethodEvent)
, Component.processHierarchyEvent(java.awt.event.HierarchyEvent)
, Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)
protected void processContainerEvent(ContainerEvent e)
addContainerListener
enableEvents
Отметьте это, если параметр события null
поведение является неуказанным и может привести к исключению.
e
- контейнерное событиеComponent.enableEvents(long)
@Deprecated public void deliverEvent(Event e)
dispatchEvent(AWTEvent e)
deliverEvent
в классе Component
public Component getComponentAt(int x, int y)
getComponentAt
в классе Component
x
- координата xy
- координата yComponent.contains(int, int)
@Deprecated public Component locate(int x, int y)
getComponentAt(int, int)
.public Component getComponentAt(Point p)
getComponentAt
в классе Component
p
- точка.null
если компонент не содержит точку.Component.contains(int, int)
public Point getMousePosition(boolean allowChildren) throws HeadlessException
Container
's координатное пространство, если Container
находится под указателем мыши, иначе возвраты null
. Этот метод подобен Component.getMousePosition()
за исключением того, что это может взять Container
's дочерние элементы во внимание. Если allowChildren
false
, этот метод возвратит ненулевое значение, только если указатель мыши выше Container
непосредственно, не выше части затеняется дочерними элементами. Если allowChildren
true
, этот метод возвращает ненулевое значение, если указатель мыши выше Container
или любой из его потомков.allowChildren
- истина, если дочерние элементы должны быть приняты во вниманиеComponent
, или нульHeadlessException
- если GraphicsEnvironment.isHeadless () возвращает trueComponent.getMousePosition()
public Component findComponentAt(int x, int y)
findComponentAt метод отличается от getComponentAt, в котором getComponentAt только ищет непосредственные дочерние элементы Контейнера; если содержанием компонента будет Контейнер, то findComponentAt будет искать тот дочерний элемент, чтобы найти вложенный компонент.
x
- координата xy
- координата yComponent.contains(int, int)
, getComponentAt(int, int)
public Component findComponentAt(Point p)
findComponentAt метод отличается от getComponentAt, в котором getComponentAt только ищет непосредственные дочерние элементы Контейнера; если содержанием компонента будет Контейнер, то findComponentAt будет искать тот дочерний элемент, чтобы найти вложенный компонент.
p
- точка.NullPointerException
- если p
null
Component.contains(int, int)
, getComponentAt(int, int)
public void addNotify()
addNotify
в классе Component
Component.isDisplayable()
, removeNotify()
public void removeNotify()
removeNotify
в классе Component
Component.isDisplayable()
, addNotify()
public boolean isAncestorOf(Component c)
c
- компонентtrue
если это - предок; false
иначе.protected String paramString()
Container
. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null
.paramString
в классе Component
public void list(PrintStream out, int indent)
Непосредственные дочерние элементы контейнера печатаются с добавлением отступа indent+1
. Дочерние элементы тех дочерних элементов печатаются в indent+2
и так далее.
list
в классе Component
out
- поток печатиindent
- число пробелов, чтобы сделать отступNullPointerException
- если out
null
Component.list(java.io.PrintStream, int)
public void list(PrintWriter out, int indent)
Непосредственные дочерние элементы контейнера печатаются с добавлением отступа indent+1
. Дочерние элементы тех дочерних элементов печатаются в indent+2
и так далее.
list
в классе Component
out
- писатель печатиindent
- число пробелов, чтобы сделать отступNullPointerException
- если out
null
Component.list(java.io.PrintWriter, int)
public void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Значения по умолчанию для ключей обхода фокуса Контейнера являются зависящими от реализации. Sun рекомендует, чтобы все реализации для определенной собственной платформы использовали те же самые значения по умолчанию. Рекомендации для Windows и Unix упоминаются ниже. Эти рекомендации используются на солнце реализации AWT.
Идентификатор | Значение | Значение по умолчанию | |
---|---|---|---|
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS | Нормальный прямой обход клавиатуры | ВКЛАДКА на 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 | Спуститесь один цикл обхода фокуса | ни один |
Используя API AWTKeyStroke, клиентский код может определить, на каком из двух определенных KeyEvents, KEY_PRESSED или KEY_RELEASED, произойдет работа обхода фокуса. Независимо от которого KeyEvent определяется, однако, весь KeyEvents, связанный с ключом обхода фокуса, включая связанное событие KEY_TYPED, будет использован, и не будет диспетчеризирован никакому Контейнеру. Это - ошибка периода выполнения, чтобы определить событие KEY_TYPED как отображающийся на работу обхода фокуса, или отобразить то же самое событие на многократные операции обхода фокуса по умолчанию.
Если значение нуля определяется для Набора, этот Контейнер наследовал Набор от своего родителя. Если у всех предков этого Контейнера есть нуль, определенный для Набора, то Набор текущего KeyboardFocusManager по умолчанию используется.
setFocusTraversalKeys
в классе Component
id
- один из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSkeystrokes
- Набор AWTKeyStroke для указанной работыIllegalArgumentException
- если идентификатор не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS, или если нажатия клавиш содержат нуль, или если каким-либо Объектом в нажатиях клавиш не является AWTKeyStroke, или если какое-либо нажатие клавиши представляет событие KEY_TYPED, или если какое-либо нажатие клавиши уже отображается на другую работу обхода фокуса для этого КонтейнераgetFocusTraversalKeys(int)
, KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
public Set<AWTKeyStroke> getFocusTraversalKeys(int id)
setFocusTraversalKeys
для полного описания каждого ключа.) Если ряд ключей обхода не был явно определен для этого Контейнера, то Набор родителя этого Контейнера возвращается. Если никакой Набор не был явно определен ни для одного из предков этого Контейнера, то Набор текущего KeyboardFocusManager по умолчанию возвращается.
getFocusTraversalKeys
в классе Component
id
- один из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSIllegalArgumentException
- если идентификатор не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSsetFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>)
, KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
public boolean areFocusTraversalKeysSet(int id)
false
, этот Контейнер наследовал Набор от предка, или от текущего KeyboardFocusManager.areFocusTraversalKeysSet
в классе Component
id
- один из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYStrue
если Набор ключей обхода фокуса для данной работы обхода фокуса был явно определен для этого Компонента; false
иначе.IllegalArgumentException
- если идентификатор не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSpublic boolean isFocusCycleRoot(Container container)
true
для обоих таких Контейнеров в этом случае.isFocusCycleRoot
в классе Component
container
- Контейнер, который будет протестированtrue
если указанный Контейнер является циклом фокуса - корень этого Контейнера; false
иначеisFocusCycleRoot()
public void setFocusTraversalPolicy(FocusTraversalPolicy policy)
Если этот Контейнер не будет корнем цикла фокуса, то политику будут помнить, но не будет использоваться или наследуется этим или любыми другими Контейнерами, пока этот Контейнер не будет сделан корнем цикла фокуса.
policy
- новая политика обхода фокуса для этого КонтейнераgetFocusTraversalPolicy()
, setFocusCycleRoot(boolean)
, isFocusCycleRoot(java.awt.Container)
public FocusTraversalPolicy getFocusTraversalPolicy()
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, setFocusCycleRoot(boolean)
, isFocusCycleRoot(java.awt.Container)
public boolean isFocusTraversalPolicySet()
false
, этот Контейнер наследует свою политику обхода фокуса от предка.true
если политика обхода фокуса была явно установлена для этого Контейнера; false
иначе.public void setFocusCycleRoot(boolean focusCycleRoot)
Альтернативный способ определить порядок обхода дочерних элементов этого Контейнера состоит в том, чтобы сделать этот Контейнер провайдером политики обхода фокуса.
focusCycleRoot
- указывает, является ли этот Контейнер корнем цикла обхода фокусаisFocusCycleRoot()
, setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, getFocusTraversalPolicy()
, ContainerOrderFocusTraversalPolicy
, setFocusTraversalPolicyProvider(boolean)
public boolean isFocusCycleRoot()
setFocusCycleRoot(boolean)
, setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, getFocusTraversalPolicy()
, ContainerOrderFocusTraversalPolicy
public final void setFocusTraversalPolicyProvider(boolean provider)
true
будет использоваться, чтобы получить политику обхода фокуса вместо самого близкого корневого предка цикла фокуса.provider
- указывает, будет ли этот контейнер использоваться, чтобы обеспечить политику обхода фокусаsetFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, getFocusTraversalPolicy()
, isFocusTraversalPolicyProvider()
public final boolean isFocusTraversalPolicyProvider()
true
тогда, когда менеджер по клавиатурному фокусу ищет контейнерную иерархию политику обхода фокуса и встречается с этим контейнером перед любым другим контейнером с этим свойством как истина или корни цикла фокуса тогда, его политика обхода фокуса будет использоваться вместо корневой политики цикла фокуса.true
если этот контейнер обеспечивает политику обхода фокуса, false
иначеsetFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, getFocusTraversalPolicy()
, setFocusCycleRoot(boolean)
, setFocusTraversalPolicyProvider(boolean)
public void transferFocusDownCycle()
Component.requestFocus()
, isFocusCycleRoot(java.awt.Container)
, setFocusCycleRoot(boolean)
public void applyComponentOrientation(ComponentOrientation o)
ComponentOrientation
свойство этого контейнера и всех компонентов содержится в пределах этого. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.
applyComponentOrientation
в классе Component
o
- новая компонентная ориентация этого контейнера и компонентов содержится в пределах этого.NullPointerException
- если orientation
нуль.Component.setComponentOrientation(java.awt.ComponentOrientation)
, Component.getComponentOrientation()
, invalidate()
public void addPropertyChangeListener(PropertyChangeListener listener)
Если слушатель является нулем, никакое исключение не выдается, и никакое действие не выполняется.
addPropertyChangeListener
в классе Component
listener
- PropertyChangeListener, который будет добавленComponent.removePropertyChangeListener(java.beans.PropertyChangeListener)
, addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Если слушатель является нулем, никакое исключение не выдается, и никакое действие не выполняется.
addPropertyChangeListener
в классе Component
propertyName
- одно из имен свойства упоминается вышеlistener
- PropertyChangeListener, который будет добавленaddPropertyChangeListener(java.beans.PropertyChangeListener)
, Component.removePropertyChangeListener(java.beans.PropertyChangeListener)
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.