BorderLayout (Платформа Java SE 7)

java.lang. Объект
- java.awt. BorderLayout

Все Реализованные Интерфейсы:

LayoutManager, LayoutManager2, Сериализуемый
```
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);
   }
 }
 
```
С тех пор:

JDK1.0

См. Также:
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()` Возвращает строковое представление состояния этого расположения границы.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - СЕВЕР
```
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
```
    Центральное ограничение расположения (середина контейнера).
    
    См. Также:
    Постоянные Значения полей
  - BEFORE_FIRST_LINE
```
public static final String BEFORE_FIRST_LINE
```
    Синоним для PAGE_START. Существует для совместимости с предыдущими версиями. PAGE_START предпочитается.
    
    С тех пор:
    
    1.2
    
    См. Также:
    PAGE_START, Постоянные Значения полей
  - AFTER_LAST_LINE
```
public static final String AFTER_LAST_LINE
```
    Синоним для PAGE_END. Существует для совместимости с предыдущими версиями. PAGE_END предпочитается.
    
    С тех пор:
    
    1.2
    
    См. Также:
    PAGE_END, Постоянные Значения полей
  - BEFORE_LINE_BEGINS
```
public static final String BEFORE_LINE_BEGINS
```
    Синоним для LINE_START. Существует для совместимости с предыдущими версиями. LINE_START предпочитается.
    
    С тех пор:
    
    1.2
    
    См. Также:
    LINE_START, Постоянные Значения полей
  - AFTER_LINE_ENDS
```
public static final String AFTER_LINE_ENDS
```
    Синоним для LINE_END. Существует для совместимости с предыдущими версиями. LINE_END предпочитается.
    
    С тех пор:
    
    1.2
    
    См. Также:
    LINE_END, Постоянные Значения полей
  - PAGE_START
```
public static final String PAGE_START
```
    Компонент прибывает перед первой строкой контента расположения. Для Западного, слева направо и ориентаций от начала до конца, это эквивалентно на СЕВЕР.
    
    С тех пор:
    
    1.4
    
    См. Также:
    Component.getComponentOrientation(), Постоянные Значения полей
  - PAGE_END
```
public static final String PAGE_END
```
    Компонент прибывает после последней строки контента расположения. Для Западного, слева направо и ориентаций от начала до конца, это эквивалентно на ЮГ.
    
    С тех пор:
    
    1.4
    
    См. Также:
    Component.getComponentOrientation(), Постоянные Значения полей
  - LINE_START
```
public static final String LINE_START
```
    Компонент идет в начале направления строки для расположения. Для Западного, слева направо и ориентаций от начала до конца, это эквивалентно на ЗАПАД.
    
    С тех пор:
    
    1.4
    
    См. Также:
    Component.getComponentOrientation(), Постоянные Значения полей
  - LINE_END
```
public static final String LINE_END
```
    Компонент идет в конце направления строки для расположения. Для Западного, слева направо и ориентаций от начала до конца, это эквивалентно на ВОСТОК.
    
    С тех пор:
    
    1.4
    
    См. Также:
    Component.getComponentOrientation(), Постоянные Значения полей
- Деталь конструктора
  - BorderLayout
```
public BorderLayout()
```
    Создает новое расположение границы без разрывов между компонентами.
  - BorderLayout
```
public BorderLayout(int hgap,
            int vgap)
```
    Создает расположение границы с указанными разрывами между компонентами. Горизонтальный разрыв определяется hgap и вертикальный разрыв определяется vgap.
    
    Параметры:
    hgap - горизонтальный разрыв.
    vgap - вертикальный разрыв.
- Деталь метода
  - getHgap
```
public int getHgap()
```
    Возвращает горизонтальный разрыв между компонентами.
    
    С тех пор:
    
    JDK1.1
  - setHgap
```
public void setHgap(int hgap)
```
    Устанавливает горизонтальный разрыв между компонентами.
    
    Параметры:
    hgap - горизонтальный разрыв между компонентами
    С тех пор:
    
    JDK1.1
  - getVgap
```
public int getVgap()
```
    Возвращает вертикальный разрыв между компонентами.
    
    С тех пор:
    
    JDK1.1
  - setVgap
```
public void setVgap(int vgap)
```
    Устанавливает вертикальный разрыв между компонентами.
    
    Параметры:
    vgap - вертикальный разрыв между компонентами
    С тех пор:
    
    JDK1.1
  - addLayoutComponent
```
public void addLayoutComponent(Component comp,
                      Object constraints)
```
    Добавляет указанный компонент к расположению, используя указанный ограничительный объект. Для разметок границы ограничение должно быть одной из следующих констант: NORTH, SOUTH, EAST, WEST, или CENTER.
    Большинство приложений не вызывает этот метод непосредственно. Этот метод вызывают, когда компонент добавляется к контейнеру, используя Container.add метод с теми же самыми типами параметра.
    
    Определенный:
    
    addLayoutComponent в интерфейсе LayoutManager2
    
    Параметры:
    comp - компонент, который будет добавлен.
    constraints - объект, который определяет, как и где компонент добавляется к расположению.
    
    Броски:
    
    IllegalArgumentException - если ограничительный объект не является строкой, или если это не одна из пяти указанных констант.
    С тех пор:
    
    JDK1.1
    
    См. Также:
    Container.add(java.awt.Component, java.lang.Object)
  - addLayoutComponent
```
@Deprecated
public void addLayoutComponent(String name,
                                 Component comp)
```
    Осуждаемый. замененный addLayoutComponent(Component, Object).
    
    Описание скопировало с интерфейса: LayoutManager
    
    Если менеджер по расположению использует строку на компонент, добавляет компонент comp к расположению, связывая это со строкой, определенной name.
    
    Определенный:
    
    addLayoutComponent в интерфейсе LayoutManager
    
    Параметры:
    name - строка, которая будет связана с компонентом
    comp - компонент, который будет добавлен
  - removeLayoutComponent
```
public void removeLayoutComponent(Component comp)
```
    Удаляет указанный компонент из этого расположения границы. Этот метод вызывают, когда контейнер вызывает remove или removeAll методы. Большинство приложений не вызывает этот метод непосредственно.
    
    Определенный:
    
    removeLayoutComponent в интерфейсе LayoutManager
    
    Параметры:
    comp - компонент, который будет удален.
    См. Также:
    Container.remove(java.awt.Component), Container.removeAll()
  - getLayoutComponent
```
public Component getLayoutComponent(Object constraints)
```
    Получает компонент, который был добавлен, используя данное ограничение
    
    Параметры:
    constraints - требуемое ограничение, один из CENTER, NORTH, SOUTH, WEST, EAST, PAGE_START, PAGE_END, LINE_START, LINE_END
    
    Возвраты:
    компонент в данном расположении, или null если расположение пусто
    
    Броски:
    
    IllegalArgumentException - если ограничительный объект не является одной из девяти указанных констант
    С тех пор:
    
    1.5
    
    См. Также:
    addLayoutComponent(java.awt.Component, java.lang.Object)
  - getLayoutComponent
```
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 - если целевой параметр является нулем
    С тех пор:
    
    1.5
    
    См. Также:
    addLayoutComponent(java.awt.Component, java.lang.Object)
  - getConstraints
```
public Object getConstraints(Component comp)
```
    Получает ограничения для указанного компонента
    
    Параметры:
    comp - компонент, который будет запрошен
    
    Возвраты:
    ограничение для указанного компонента, или нуль, если компонент является нулем или не присутствует в этом расположении
    С тех пор:
    
    1.5
    
    См. Также:
    addLayoutComponent(java.awt.Component, java.lang.Object)
  - minimumLayoutSize
```
public Dimension minimumLayoutSize(Container target)
```
    Определяет минимальный размер target контейнер используя этого менеджера по расположению.
    Этот метод вызывают, когда контейнер вызывает getMinimumSize метод. Большинство приложений не вызывает этот метод непосредственно.
    
    Определенный:
    
    minimumLayoutSize в интерфейсе LayoutManager
    
    Параметры:
    target - контейнер, в котором можно сделать расположение.
    
    Возвраты:
    минимальные размерности должны были разметить субкомпоненты указанного контейнера.
    См. Также:
    Container, preferredLayoutSize(java.awt.Container), Container.getMinimumSize()
  - preferredLayoutSize
```
public Dimension preferredLayoutSize(Container target)
```
    Определяет привилегированный размер target контейнер используя этого менеджера по расположению, основанного на компонентах в контейнере.
    Большинство приложений не вызывает этот метод непосредственно. Этот метод вызывают, когда контейнер вызывает getPreferredSize метод.
    
    Определенный:
    
    preferredLayoutSize в интерфейсе LayoutManager
    
    Параметры:
    target - контейнер, в котором можно сделать расположение.
    
    Возвраты:
    привилегированные размерности, чтобы разметить субкомпоненты указанного контейнера.
    См. Также:
    Container, minimumLayoutSize(java.awt.Container), Container.getPreferredSize()
  - maximumLayoutSize
```
public Dimension maximumLayoutSize(Container target)
```
    Возвращает максимальные размерности для этого расположения, данного компоненты в указанном целевом контейнере.
    
    Определенный:
    
    maximumLayoutSize в интерфейсе LayoutManager2
    
    Параметры:
    target - компонент, который должен быть размечен
    См. Также:
    Container, minimumLayoutSize(java.awt.Container), preferredLayoutSize(java.awt.Container)
  - getLayoutAlignmentX
```
public float getLayoutAlignmentX(Container parent)
```
    Возвращает выравнивание вдоль оси X. Это определяет, как компонент хотел бы быть выровненный относительно других компонентов. Значение должно быть числом между 0 и 1, где 0 представляет выравнивание вдоль источника, 1 выровненный, самое далекое далеко от источника, 0.5 центрируется и т.д.
    
    Определенный:
    
    getLayoutAlignmentX в интерфейсе LayoutManager2
  - getLayoutAlignmentY
```
public float getLayoutAlignmentY(Container parent)
```
    Возвращает выравнивание вдоль оси Y. Это определяет, как компонент хотел бы быть выровненный относительно других компонентов. Значение должно быть числом между 0 и 1, где 0 представляет выравнивание вдоль источника, 1 выровненный, самое далекое далеко от источника, 0.5 центрируется и т.д.
    
    Определенный:
    
    getLayoutAlignmentY в интерфейсе LayoutManager2
  - invalidateLayout
```
public void invalidateLayout(Container target)
```
    Лишает законной силы расположение, указывая, что, если менеджер по расположению кэшировал информацию, это должно быть отброшено.
    
    Определенный:
    
    invalidateLayout в интерфейсе LayoutManager2
  - layoutContainer
```
public void layoutContainer(Container target)
```
    Размечает контейнерный параметр, используя это расположение границы.
    Этот метод фактически изменяет компоненты в указанном контейнере, чтобы удовлетворить ограничения этого BorderLayout объект. NORTH и SOUTH компоненты, если таковые вообще имеются, помещаются вверху и внизу контейнера, соответственно. WEST и EAST компоненты тогда помещаются слева и право, соответственно. Наконец, CENTER объект помещается в любое остающееся пространство в середине.
    Большинство приложений не вызывает этот метод непосредственно. Этот метод вызывают, когда контейнер вызывает doLayout метод.
    
    Определенный:
    
    layoutContainer в интерфейсе LayoutManager
    
    Параметры:
    target - контейнер, в котором можно сделать расположение.
    См. Также:
    Container, Container.doLayout()
  - toString
```
public String toString()
```
    Возвращает строковое представление состояния этого расположения границы.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    строковое представление этого расположения границы.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс BorderLayout

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

СЕВЕР

ЮГ

ВОСТОК

ЗАПАД

ЦЕНТР

BEFORE_FIRST_LINE

AFTER_LAST_LINE

BEFORE_LINE_BEGINS

AFTER_LINE_ENDS

PAGE_START

PAGE_END

LINE_START

LINE_END

Деталь конструктора

BorderLayout

BorderLayout

Деталь метода

getHgap

setHgap

getVgap

setVgap

addLayoutComponent

addLayoutComponent

removeLayoutComponent

getLayoutComponent

getLayoutComponent

getConstraints

minimumLayoutSize

preferredLayoutSize

maximumLayoutSize

getLayoutAlignmentX

getLayoutAlignmentY

invalidateLayout

layoutContainer

toString