jdk.awt.BorderLayout

Liking cljdoc? Tell your friends :D

Clojure only.

A border layout lays out a container, arranging and resizing its components to fit in five regions: north, south, east, west, and center. Each region may contain no more than one component, and is identified by a corresponding constant: NORTH, SOUTH, EAST, WEST, and CENTER. When adding a component to a container with a border layout, use one of these five constants, for example:

Panel p = new Panel(); p.setLayout(new BorderLayout()); p.add(new Button("Okay"), BorderLayout.SOUTH); As a convenience, BorderLayout interprets the absence of a string specification the same as the constant CENTER:

Panel p2 = new Panel(); p2.setLayout(new BorderLayout()); p2.add(new TextArea()); // Same as p.add(new TextArea(), BorderLayout.CENTER);

In addition, BorderLayout supports the relative positioning constants, PAGE_START, PAGE_END, LINE_START, and LINE_END. In a container whose ComponentOrientation is set to ComponentOrientation.LEFT_TO_RIGHT, these constants map to NORTH, SOUTH, WEST, and EAST, respectively.

For compatibility with previous releases, BorderLayout also includes the relative positioning constants BEFORE_FIRST_LINE, AFTER_LAST_LINE, BEFORE_LINE_BEGINS and AFTER_LINE_ENDS. These are equivalent to PAGE_START, PAGE_END, LINE_START and LINE_END respectively. For consistency with the relative positioning constants used by other components, the latter constants are preferred.

Mixing both absolute and relative positioning constants can lead to unpredictable results. If you use both types, the relative constants will take precedence. For example, if you add components using both the NORTH and PAGE_START constants in a container whose orientation is LEFT_TO_RIGHT, only the PAGE_START will be layed out.

NOTE: Currently (in the Java 2 platform v1.2), BorderLayout does not support vertical orientations. The isVertical setting on the container's ComponentOrientation is not respected.

The components are laid out according to their preferred sizes and the constraints of the container's size. The NORTH and SOUTH components may be stretched horizontally; the EAST and WEST components may be stretched vertically; the CENTER component may stretch both horizontally and vertically to fill any space left over.

Here is an example of five buttons in an applet laid out using the BorderLayout layout manager:

The code for this applet is as follows:

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); } }

A border layout lays out a container, arranging and resizing
its components to fit in five regions:
north, south, east, west, and center.
Each region may contain no more than one component, and
is identified by a corresponding constant:
NORTH, SOUTH, EAST,
WEST, and CENTER.  When adding a
component to a container with a border layout, use one of these
five constants, for example:


   Panel p = new Panel();
   p.setLayout(new BorderLayout());
   p.add(new Button("Okay"), BorderLayout.SOUTH);
As a convenience, BorderLayout interprets the
absence of a string specification the same as the constant
CENTER:


   Panel p2 = new Panel();
   p2.setLayout(new BorderLayout());
   p2.add(new TextArea());  // Same as p.add(new TextArea(), BorderLayout.CENTER);

In addition, BorderLayout supports the relative
positioning constants, PAGE_START, PAGE_END,
LINE_START, and LINE_END.
In a container whose ComponentOrientation is set to
ComponentOrientation.LEFT_TO_RIGHT, these constants map to
NORTH, SOUTH, WEST, and
EAST, respectively.

For compatibility with previous releases, BorderLayout
also includes the relative positioning constants BEFORE_FIRST_LINE,
AFTER_LAST_LINE, BEFORE_LINE_BEGINS and
AFTER_LINE_ENDS.  These are equivalent to
PAGE_START, PAGE_END, LINE_START
and LINE_END respectively.  For
consistency with the relative positioning constants used by other
components, the latter constants are preferred.

Mixing both absolute and relative positioning constants can lead to
unpredictable results.  If
you use both types, the relative constants will take precedence.
For example, if you add components using both the NORTH
and PAGE_START constants in a container whose
orientation is LEFT_TO_RIGHT, only the
PAGE_START will be layed out.

NOTE: Currently (in the Java 2 platform v1.2),
BorderLayout does not support vertical
orientations.  The isVertical setting on the container's
ComponentOrientation is not respected.

The components are laid out according to their
preferred sizes and the constraints of the container's size.
The NORTH and SOUTH components may
be stretched horizontally; the EAST and
WEST components may be stretched vertically;
the CENTER component may stretch both horizontally
and vertically to fill any space left over.

Here is an example of five buttons in an applet laid out using
the BorderLayout layout manager:



The code for this applet is as follows:



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);
  }
}

jdk.awt.BorderLayout

*-after-last-lineclj

*-after-line-endsclj

*-before-first-lineclj

*-before-line-beginsclj

*-centerclj

*-eastclj

*-line-endclj

*-line-startclj

*-northclj

*-page-endclj

*-page-startclj

*-southclj

*-westclj

->border-layoutclj

add-layout-componentclj

get-constraintsclj

get-hgapclj

get-layout-alignment-xclj

get-layout-alignment-yclj

get-layout-componentclj

get-vgapclj

invalidate-layoutclj

layout-containerclj

maximum-layout-sizeclj

minimum-layout-sizeclj

preferred-layout-sizeclj

remove-layout-componentclj

set-hgapclj

set-vgapclj

to-stringclj

*-after-last-line^clj

*-after-line-ends^clj

*-before-first-line^clj

*-before-line-begins^clj

*-center^clj

*-east^clj

*-line-end^clj

*-line-start^clj

*-north^clj

*-page-end^clj

*-page-start^clj

*-south^clj

*-west^clj

->border-layout^clj

add-layout-component^clj

get-constraints^clj

get-hgap^clj

get-layout-alignment-x^clj

get-layout-alignment-y^clj

get-layout-component^clj

get-vgap^clj

invalidate-layout^clj

layout-container^clj

maximum-layout-size^clj

minimum-layout-size^clj

preferred-layout-size^clj

remove-layout-component^clj

set-hgap^clj

set-vgap^clj

to-string^clj