VBOX item type

Defines a layout area to render child elements in vertical direction.

VBOX item basics

The VBOX container automatically packs the contained elements vertically from top to bottom.

Contained elements are packed in the order in which they appear in the LAYOUT section of the form file.

No decoration (border) is added when you use a VBOX container.

By combining VBOX and HBOX containers, you can define any alignment you choose.

Defining an VBOX

A VBOX is defined in a grid-based LAYOUT tree, as a container for other form items. It can for example be combined with an HBOX container to pack form elements to be displayed in vertical and horizontal directions:

LAYOUT
  HBOX
    VBOX
      GROUP
         ...
      END
      TABLE
         ...
      END
    END
    VBOX
      ...
    END
  END
END

Front-ends support different presentation and behavior options, which can be controlled by a STYLE attribute. For more details, see Style attributes common to all elements.

Where to use a VBOX

A VBOX form item can only be defined as a VBOX container in a LAYOUT tree, within a grid-based layout.

Note: A VBOX cannot be used inside a STACK container.