Class Box

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.Box
All Implemented Interfaces:
ImageObserver,MenuContainer,Serializable,Accessible
@JavaBean(defaultProperty="accessibleContext")public classBoxextendsJComponentimplementsAccessible
A lightweight container that uses a BoxLayout object as its layout manager. Box provides several class methods that are useful for containers using BoxLayout -- even non-Box containers.

TheBox class can create several kinds of invisible components that affect layout: glue, struts, and rigid areas. If all the components yourBox contains have a fixed size, you might want to use a glue component (returned bycreateGlue) to control the components' positions. If you need a fixed amount of space between two components, try using a strut (createHorizontalStrut orcreateVerticalStrut). If you need an invisible component that always takes up the same amount of space, get it by invokingcreateRigidArea.

If you are implementing aBoxLayout you can find further information and examples inHow to Use BoxLayout, a section inThe Java Tutorial.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans has been added to thejava.beans package. Please seeXMLEncoder.

Since:
1.2
See Also:

  • Constructor Details

  • Method Details

    • createHorizontalBox

      public static Box createHorizontalBox()
      Creates aBox that displays its components from left to right. If you want aBox that respects the component orientation you should create theBox using the constructor and pass inBoxLayout.LINE_AXIS, eg:
         Box lineBox = new Box(BoxLayout.LINE_AXIS);
      Returns:
      the box

    • createVerticalBox

      public static Box createVerticalBox()
      Creates aBox that displays its components from top to bottom. If you want aBox that respects the component orientation you should create theBox using the constructor and pass inBoxLayout.PAGE_AXIS, eg:
         Box lineBox = new Box(BoxLayout.PAGE_AXIS);
      Returns:
      the box

    • createRigidArea

      public static Component createRigidArea(Dimension d)
      Creates an invisible component that's always the specified size.
      Parameters:
      d - the dimensions of the invisible component
      Returns:
      the component
      See Also:

    • createHorizontalStrut

      public static Component createHorizontalStrut(int width)
      Creates an invisible, fixed-width component. In a horizontal box, you typically use this method to force a certain amount of space between two components. In a vertical box, you might use this method to force the box to be at least the specified width. The invisible component has no height unless excess space is available, in which case it takes its share of available space, just like any other component that has no maximum height.
      Parameters:
      width - the width of the invisible component, in pixels >= 0
      Returns:
      the component
      See Also:

    • createVerticalStrut

      public static Component createVerticalStrut(int height)
      Creates an invisible, fixed-height component. In a vertical box, you typically use this method to force a certain amount of space between two components. In a horizontal box, you might use this method to force the box to be at least the specified height. The invisible component has no width unless excess space is available, in which case it takes its share of available space, just like any other component that has no maximum width.
      Parameters:
      height - the height of the invisible component, in pixels >= 0
      Returns:
      the component
      See Also:

    • createGlue

      public static Component createGlue()
      Creates an invisible "glue" component that can be useful in a Box whose visible components have a maximum width (for a horizontal box) or height (for a vertical box). You can think of the glue component as being a gooey substance that expands as much as necessary to fill the space between its neighboring components.

      For example, suppose you have a horizontal box that contains two fixed-size components. If the box gets extra space, the fixed-size components won't become larger, so where does the extra space go? Without glue, the extra space goes to the right of the second component. If you put glue between the fixed-size components, then the extra space goes there. If you put glue before the first fixed-size component, the extra space goes there, and the fixed-size components are shoved against the right edge of the box. If you put glue before the first fixed-size component and after the second fixed-size component, the fixed-size components are centered in the box.

      To use glue, callBox.createGlue and add the returned component to a container. The glue component has no minimum or preferred size, so it takes no space unless excess space is available. If excess space is available, then the glue component takes its share of available horizontal or vertical space, just like any other component that has no maximum width or height.

      Returns:
      the component

    • createHorizontalGlue

      public static Component createHorizontalGlue()
      Creates a horizontal glue component.
      Returns:
      the component

    • createVerticalGlue

      public static Component createVerticalGlue()
      Creates a vertical glue component.
      Returns:
      the component

    • setLayout

      public void setLayout(LayoutManager l)
      Throws an AWTError, since a Box can use only a BoxLayout.
      Overrides:
      setLayout in class Container
      Parameters:
      l - the layout manager to use
      See Also:

    • paintComponent

      protected void paintComponent(Graphics g)
      Paints thisBox. If thisBox has a UI this method invokes super's implementation, otherwise if thisBox is opaque theGraphics is filled using the background.
      Overrides:
      paintComponent in class JComponent
      Parameters:
      g - theGraphics to paint to
      Throws:
      NullPointerException - ifg is null
      Since:
      1.6
      See Also:

    • getAccessibleContext

      @BeanProperty(bound=false)public AccessibleContext getAccessibleContext()
      Gets the AccessibleContext associated with this Box. For boxes, the AccessibleContext takes the form of an AccessibleBox. A new AccessibleAWTBox instance is created if necessary.
      Specified by:
      getAccessibleContext in interface Accessible
      Overrides:
      getAccessibleContext in class Component
      Returns:
      an AccessibleBox that serves as the AccessibleContext of this Box