Spec-Zone .ru
спецификации, руководства, описания, API
|
public class BorderLayout extends Object implements LayoutManager2, Serializable
NORTH
, SOUTH
, EAST
, WEST
, и CENTER
. Добавляя компонент к контейнеру с расположением границы, используйте одну из этих пяти констант, например: Panel p = new Panel(); p.setLayout(new BorderLayout()); p.add(new Button("Okay"), BorderLayout.SOUTH);Как удобство,
BorderLayout
интерпретирует отсутствие строковой спецификации то же самое как константа CENTER
: Panel p2 = new Panel(); p2.setLayout(new BorderLayout()); p2.add(new TextArea()); // Same as p.add(new TextArea(), BorderLayout.CENTER);
Кроме того, BorderLayout
поддерживает относительные константы расположения, PAGE_START
, PAGE_END
, LINE_START
, и LINE_END
. В контейнере, чей ComponentOrientation
устанавливается в ComponentOrientation.LEFT_TO_RIGHT
, эти константы отображаются на NORTH
, SOUTH
, WEST
, и EAST
, соответственно.
Для совместимости с предыдущими выпусками, BorderLayout
также включает относительные константы расположения BEFORE_FIRST_LINE
, AFTER_LAST_LINE
, BEFORE_LINE_BEGINS
и AFTER_LINE_ENDS
. Они эквивалентны PAGE_START
, PAGE_END
, LINE_START
и LINE_END
соответственно. Для непротиворечивости с относительными константами расположения, используемыми другими компонентами, предпочитаются последние константы.
Смешивание и абсолютные и относительные константы расположения может привести к результатам unpredicable. Если Вы будете использовать оба типа, то относительные константы будут иметь приоритет. Например, если Вы добавляете компоненты, используя обоих NORTH
и PAGE_START
константы в контейнере, ориентация которого LEFT_TO_RIGHT
, только PAGE_START
будет layed.
ОТМЕТЬТЕ: В настоящий момент (в Java 2 платформы v1.2), BorderLayout
не поддерживает вертикальные ориентации. isVertical
установка на контейнере ComponentOrientation
не уважается.
Компоненты размечаются согласно их привилегированным размерам и ограничениям размера контейнера. NORTH
и SOUTH
компоненты могут быть расширены горизонтально; EAST
и WEST
компоненты могут быть расширены вертикально; CENTER
компонент может простираться и горизонтально и вертикально заполнить любое перенесенное пространство.
Вот пример пяти кнопок в апплете, размеченном, используя BorderLayout
менеджер по расположению:
Код для этого апплета следующие:
import java.awt.*; import java.applet.Applet; public class buttonDir extends Applet { public void init() { setLayout(new BorderLayout()); add(new Button("North"), BorderLayout.NORTH); add(new Button("South"), BorderLayout.SOUTH); add(new Button("East"), BorderLayout.EAST); add(new Button("West"), BorderLayout.WEST); add(new Button("Center"), BorderLayout.CENTER); } }
Container.add(String, Component)
, ComponentOrientation
, Сериализированная ФормаМодификатор и Тип | Поле и Описание |
---|---|
static String |
AFTER_LAST_LINE
Синоним для PAGE_END.
|
static String |
AFTER_LINE_ENDS
Синоним для LINE_END.
|
static String |
BEFORE_FIRST_LINE
Синоним для PAGE_START.
|
static String |
BEFORE_LINE_BEGINS
Синоним для LINE_START.
|
static String |
ЦЕНТР
Центральное ограничение расположения (середина контейнера).
|
static String |
ВОСТОК
Восточное ограничение расположения (правая сторона контейнера).
|
static String |
LINE_END
Компонент идет в конце направления строки для расположения.
|
static String |
LINE_START
Компонент идет в начале направления строки для расположения.
|
static String |
СЕВЕР
Северное ограничение расположения (вершина контейнера).
|
static String |
PAGE_END
Компонент прибывает после последней строки контента расположения.
|
static String |
PAGE_START
Компонент прибывает перед первой строкой контента расположения.
|
static String |
ЮГ
Южное ограничение расположения (нижняя часть контейнера).
|
static String |
ЗАПАД
Западное ограничение расположения (левая сторона контейнера).
|
Конструктор и Описание |
---|
BorderLayout()
Создает новое расположение границы без разрывов между компонентами.
|
BorderLayout(int hgap, int vgap)
Создает расположение границы с указанными разрывами между компонентами.
|
Модификатор и Тип | Метод и Описание |
---|---|
void |
addLayoutComponent(Component comp, Object constraints)
Добавляет указанный компонент к расположению, используя указанный ограничительный объект.
|
void |
addLayoutComponent(String name, Component comp)
Осуждаемый.
замененный
addLayoutComponent(Component, Object) . |
Объект |
getConstraints(Component comp)
Получает ограничения для указанного компонента
|
int |
getHgap()
Возвращает горизонтальный разрыв между компонентами.
|
float |
getLayoutAlignmentX(Container parent)
Возвращает выравнивание вдоль оси X.
|
float |
getLayoutAlignmentY(Container parent)
Возвращает выравнивание вдоль оси Y.
|
Компонент |
getLayoutComponent(Container target, Object constraints)
Возвращает компонент, который соответствует данному ограничительному расположению, основанному на цели
Container 's компонентная ориентация. |
Компонент |
getLayoutComponent(Object constraints)
Получает компонент, который был добавлен, используя данное ограничение
|
int |
getVgap()
Возвращает вертикальный разрыв между компонентами.
|
void |
invalidateLayout(Container target)
Лишает законной силы расположение, указывая, что, если менеджер по расположению кэшировал информацию, это должно быть отброшено.
|
void |
layoutContainer(Container target)
Размечает контейнерный параметр, используя это расположение границы.
|
Размерность |
maximumLayoutSize(Container target)
Возвращает максимальные размерности для этого расположения, данного компоненты в указанном целевом контейнере.
|
Размерность |
minimumLayoutSize(Container target)
Определяет минимальный размер
target контейнер используя этого менеджера по расположению. |
Размерность |
preferredLayoutSize(Container target)
Определяет привилегированный размер
target контейнер используя этого менеджера по расположению, основанного на компонентах в контейнере. |
void |
removeLayoutComponent(Component comp)
Удаляет указанный компонент из этого расположения границы.
|
void |
setHgap(int hgap)
Устанавливает горизонтальный разрыв между компонентами.
|
void |
setVgap(int vgap)
Устанавливает вертикальный разрыв между компонентами.
|
Строка |
toString()
Возвращает строковое представление состояния этого расположения границы.
|
public static final String NORTH
public static final String SOUTH
public static final String EAST
public static final String WEST
public static final String CENTER
public static final String BEFORE_FIRST_LINE
PAGE_START
, Постоянные Значения полейpublic static final String AFTER_LAST_LINE
PAGE_END
, Постоянные Значения полейpublic static final String BEFORE_LINE_BEGINS
LINE_START
, Постоянные Значения полейpublic static final String AFTER_LINE_ENDS
LINE_END
, Постоянные Значения полейpublic static final String PAGE_START
Component.getComponentOrientation()
, Постоянные Значения полейpublic static final String PAGE_END
Component.getComponentOrientation()
, Постоянные Значения полейpublic static final String LINE_START
Component.getComponentOrientation()
, Постоянные Значения полейpublic static final String LINE_END
Component.getComponentOrientation()
, Постоянные Значения полейpublic BorderLayout()
public BorderLayout(int hgap, int vgap)
hgap
и вертикальный разрыв определяется vgap
.hgap
- горизонтальный разрыв.vgap
- вертикальный разрыв.public int getHgap()
public void setHgap(int hgap)
hgap
- горизонтальный разрыв между компонентамиpublic int getVgap()
public void setVgap(int vgap)
vgap
- вертикальный разрыв между компонентамиpublic void addLayoutComponent(Component comp, Object constraints)
NORTH
, SOUTH
, EAST
, WEST
, или CENTER
. Большинство приложений не вызывает этот метод непосредственно. Этот метод вызывают, когда компонент добавляется к контейнеру, используя Container.add
метод с теми же самыми типами параметра.
addLayoutComponent
в интерфейсе LayoutManager2
comp
- компонент, который будет добавлен.constraints
- объект, который определяет, как и где компонент добавляется к расположению.IllegalArgumentException
- если ограничительный объект не является строкой, или если это не одна из пяти указанных констант.Container.add(java.awt.Component, java.lang.Object)
@Deprecated public void addLayoutComponent(String name, Component comp)
addLayoutComponent(Component, Object)
.LayoutManager
comp
к расположению, связывая это со строкой, определенной name
.addLayoutComponent
в интерфейсе LayoutManager
name
- строка, которая будет связана с компонентомcomp
- компонент, который будет добавленpublic void removeLayoutComponent(Component comp)
remove
или removeAll
методы. Большинство приложений не вызывает этот метод непосредственно.removeLayoutComponent
в интерфейсе LayoutManager
comp
- компонент, который будет удален.Container.remove(java.awt.Component)
, Container.removeAll()
public Component getLayoutComponent(Object constraints)
constraints
- требуемое ограничение, один из CENTER
, NORTH
, SOUTH
, WEST
, EAST
, PAGE_START
, PAGE_END
, LINE_START
, LINE_END
null
если расположение пустоIllegalArgumentException
- если ограничительный объект не является одной из девяти указанных константaddLayoutComponent(java.awt.Component, java.lang.Object)
public Component getLayoutComponent(Container target, Object constraints)
Container
's компонентная ориентация. Компоненты добавили с относительными ограничениями PAGE_START
, PAGE_END
, LINE_START
, и LINE_END
имейте приоритет по компонентам, добавленным с явными ограничениями NORTH
, SOUTH
, WEST
, и EAST
. Container
's компонентная ориентация используется, чтобы определить расположение компонентов, добавленных с LINE_START
и LINE_END
.constraints
- требуемая абсолютная позиция, один из CENTER
, NORTH
, SOUTH
, EAST
, WEST
target
- Container
используемый, чтобы получить ограничительное расположение, основанное на цели Container
's компонентная ориентация.null
если расположение пустоIllegalArgumentException
- если ограничительный объект не является одной из пяти указанных константNullPointerException
- если целевой параметр является нулемaddLayoutComponent(java.awt.Component, java.lang.Object)
public Object getConstraints(Component comp)
comp
- компонент, который будет запрошенaddLayoutComponent(java.awt.Component, java.lang.Object)
public Dimension minimumLayoutSize(Container target)
target
контейнер используя этого менеджера по расположению. Этот метод вызывают, когда контейнер вызывает getMinimumSize
метод. Большинство приложений не вызывает этот метод непосредственно.
minimumLayoutSize
в интерфейсе LayoutManager
target
- контейнер, в котором можно сделать расположение.Container
, preferredLayoutSize(java.awt.Container)
, Container.getMinimumSize()
public Dimension preferredLayoutSize(Container target)
target
контейнер используя этого менеджера по расположению, основанного на компонентах в контейнере. Большинство приложений не вызывает этот метод непосредственно. Этот метод вызывают, когда контейнер вызывает getPreferredSize
метод.
preferredLayoutSize
в интерфейсе LayoutManager
target
- контейнер, в котором можно сделать расположение.Container
, minimumLayoutSize(java.awt.Container)
, Container.getPreferredSize()
public Dimension maximumLayoutSize(Container target)
maximumLayoutSize
в интерфейсе LayoutManager2
target
- компонент, который должен быть размеченContainer
, minimumLayoutSize(java.awt.Container)
, preferredLayoutSize(java.awt.Container)
public float getLayoutAlignmentX(Container parent)
getLayoutAlignmentX
в интерфейсе LayoutManager2
public float getLayoutAlignmentY(Container parent)
getLayoutAlignmentY
в интерфейсе LayoutManager2
public void invalidateLayout(Container target)
invalidateLayout
в интерфейсе LayoutManager2
public void layoutContainer(Container target)
Этот метод фактически изменяет компоненты в указанном контейнере, чтобы удовлетворить ограничения этого BorderLayout
объект. NORTH
и SOUTH
компоненты, если таковые вообще имеются, помещаются вверху и внизу контейнера, соответственно. WEST
и EAST
компоненты тогда помещаются слева и право, соответственно. Наконец, CENTER
объект помещается в любое остающееся пространство в середине.
Большинство приложений не вызывает этот метод непосредственно. Этот метод вызывают, когда контейнер вызывает doLayout
метод.
layoutContainer
в интерфейсе LayoutManager
target
- контейнер, в котором можно сделать расположение.Container
, Container.doLayout()
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92