类 java.awt.BorderLayout

java.lang.Object
   |
   +----java.awt.BorderLayout

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"), "South");
 

    Panel p2 = new Panel();
    p2.setLayout(new BorderLayout());
    p2.add(new TextArea());  // 与 p.add(new TextArea(), "Center") 方
法相同;
 

根据组件的最佳尺寸和容器尺寸的约束条件来对组件进行布局。 North 和 South 组件可在水平方向进行伸展；East 和 West 组件可在垂直方向进行伸展；Center 组件可在水平和垂直两个方向上伸展，来填充整个剩余空间。

这是一个使用 BorderLayout 布局管理器的例子，它对一个 applet 中的五个按钮进行布局：

如下是这个 applet 的代码：

 import java.awt.*;
 import java.applet.Applet;
 public class buttonDir extends Applet {
     public void init() {
     setLayout(new BorderLayout());
     add("North",  new Button("North"));
     add("South",  new Button("South"));
     add("East",   new Button("East"));
     add("West",   new Button("West"));
     add("Center", new Button("Center"));
   }
 }
 

来自：

JDK1.0

参见：

java.awt.Container.add

变量索引

CENTER

中央区域的布局约束条件 ( 容器的中央 ) 。

EAST

东区域的布局约束条件 ( 容器的左边 ) 。

NORTH

北区域的布局约束条件 ( 容器的顶部 ) 。

SOUTH

南区域的布局约束条件 ( 容器的底部 ) 。

WEST

西区域的布局约束条件 ( 容器的右边 ) 。

构造子索引

BorderLayout()

构造一个新的边界布局，组件中没有间距。

BorderLayout(int, int)

构造一个边界布局，组件间指存在指定的间距。

方法索引

addLayoutComponent(Component, Object)

用指定的约束条件对象，将指定的组件添加到布局中。

addLayoutComponent(String, Component)

不推荐使用该方法。

getHgap()

返回两个组件之间的水平间距。

getLayoutAlignmentX(Container)

返回沿 X 轴 的对齐方式。

getLayoutAlignmentY(Container)

返回沿 Y 轴 的对齐方式。

getVgap()

返回两个组件之间的垂直间距。

invalidateLayout(Container)

该方法使布局无效，表示若布局管理器具有缓存信息，则它应被删除。

layoutContainer(Container)

使用这个边界布局对容器参数进行布局。

maximumLayoutSize(Container)

在给出指定目标容器组件的前提下，返回这个布局的最大尺寸。

minimumLayoutSize(Container)

使用这个布局管理器，确定目标容器的最小尺寸。

preferredLayoutSize(Container)

使用这个布局管理器，根据容器中的组件确定目标容器的最佳尺寸。

removeLayoutComponent(Component)

从这个边界布局中删除指定的组件。

setHgap(int)

设置两个组件之间的水平间距。

setVgap(int)

设置两个组件之间的垂直间距。

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 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方法，将一个组件添加到一个容器中时，用相同的参数类型调用该方法。

参数：

comp - 要添加的组件。

constraints - 指明组件添加到布局中的方式和位置的对象。

抛出： IllegalArgumentException

若约束条件对象不是一个字符串，或不是五个指定字符串中的一个。

参见：

add

 public void addLayoutComponent(String name,
                                Component comp)

注意：不推荐使用 addLayoutComponent() 方法。 用 addLayoutComponent(Component, Object) 方法替换。.

 public void removeLayoutComponent(Component comp)

从这个边界布局中删除指定的组件。当容器调用它的 remove 或 removeAll 方法时，该方法被调用。大多数应用不直接调用该方法。

参数：

comp - 要删除的组件。

参见：

remove, removeAll

 public Dimension minimumLayoutSize(Container target)

使用该布局管理器，确定目标容器的最小尺寸。

当容器调用它的 getMinimumSize 方法时，该方法被调用。大多数应用不直接调用该方法。

参数：

target - 要进行布局的容器。

返回值：

对指定的容器的子组件进行布局需要的最小尺寸。

参见：

Container, preferredLayoutSize, getMinimumSize

 public Dimension preferredLayoutSize(Container target)

使用该布局管理器，根据容器中的组件确定目标容器的最佳尺寸。

大多数应用不直接调用该方法。当容器调用它的 getPreferredSize 方法时，该方法被调用。

参数：

target - 要进行布局的容器。

返回值：

对指定容器的子组件进行布局的最佳尺寸。

参见：

Container, minimumLayoutSize, getPreferredSize

 public Dimension maximumLayoutSize(Container target)

在给出指定目标容器组件的前提下，返回这个布局的最大尺寸。

参数：

target - 要布局的组件

参见：

Container, minimumLayoutSize, preferredLayoutSize

 public float getLayoutAlignmentX(Container parent)

返回沿 X 轴 的对齐方式。它指定了该组件相对于其它组件的对齐方式。该值应是一个介于 0 和 1 之间的数，其中 0 表示按原点对齐，1 表示按离原点最远的点对齐，0.5 表示居中对齐等。

 public float getLayoutAlignmentY(Container parent)

返回沿 Y 轴 的对齐方式。它指定了该组件相对于其它组件的对齐方式。该值应是一个介于 0 和 1 之间的数，其中 0 表示按原点对齐，1 表示按离原点最远的点对齐，0.5 表示居中对齐等。

 public void invalidateLayout(Container target)

该方法使布局无效，表示若布局管理器具有存储信息，则它应被删除。

 public void layoutContainer(Container target)

使用这个边界布局对容器参数进行布局。

事实上，该方法调整指定容器中组件的形状，使其满足该 BorderLayout 对象的约束条件。若存在 North 组件和 South 组件，分别放在容器的顶部和底部。相应的，West 组件和 East 组件分别放在容器的左边和右边。最后， Center 对象放在中间剩余的任何区域上。

大多数应用不直接调用该方法。当容器调用它的 doLayout 方法时，该方法被调用。

参数：

target - 要进行布局的容器。

参见：

Container, doLayout

 public String toString()

返回该边界布局的状态的字符串表示。

返回值：

边界布局的字符串表示。

覆盖：

类 Object 中的 toString