DOCUMENTATION CENTER SEARCH

New to Mathematica? Find your learning path »

Mathematica > Notebooks and Documents > Layout & Tables > Grids & Tables > Column >

Mathematica > Visualization and Graphics > Data Visualization > Layout & Tables > Grids & Tables > Column >

Mathematica > Data Manipulation > Statistical Data Analysis > Statistical Visualization > Data Visualization > Layout & Tables > Grids & Tables > Column >

Column

is an object that formats with the

arranged in a column, with

above

, etc.

aligns each element horizontally in the specified way.

leaves the specified number of x-heights of spacing between successive elements.

MORE INFORMATION

Possible alignments are:

	Center	centered
	Left	left justified (default)
	Right	right justified
	"c"	align on the character
	{h,v}	separate horizontal and vertical alignment

Column[...] formats as a column in StandardForm, TraditionalForm, and OutputForm.

In InputForm, Column[...] formats literally as Column[...].

First[col] extracts the list that makes up a column.

The can be expressions of any kind, including graphics and controls.

You can enter text as an element of a Column by giving it as a string. You can use Text or Style to specify a particular style.

The following options can be given:

	Alignment	{Left,Baseline}	horizontal and vertical alignment of items
	Background	None	what background colors to use
	BaselinePosition	Automatic	what to align with a surrounding text baseline
	BaseStyle	{}	base style specifications for the column
	DefaultElement	"\[Placeholder]"	what element to insert in an empty item
	Dividers	None	where to draw divider lines in the column
	Frame	None	where to draw frames in the column
	FrameStyle	Automatic	style to use for frames
	ItemSize	Automatic	width and height of each item
	ItemStyle	None	individual styles for items
	Spacings	Automatic	horizontal and vertical spacings

Common settings for Frame include:

	None	no frame
	True	frame around the whole column
	All	frame around every item in the column

Column is equivalent to Column.

Column corresponds to the setting Spacings->spacing.

Background and ItemStyle can be lists giving settings for each item in the column.

Settings for the options Alignment, Background, Frame, ItemSize, and ItemStyle can be given as follows to apply separately to successive items in the column:

	{s₁,s₂,...,s_n}	use through , then use defaults
	{{c}}	use c in all cases
	{{c₁,c₂}}	alternate between and
	{{c₁,c₂,...}}	cycle through all
	{s,{c}}	use s, then repeatedly use c
	{s₁,{c},s_n}	use , then repeatedly use c, but use at the end
	{s₁,s₂,...,{c₁, c₂, ... }, s_m, ... , s_n}	use the first sequence of at the beginning, then cyclically use the , then use the last sequence of at the end
	{s₁,s₂,...,{},s_m,...,s_n}	use the first sequence of at the beginning and the last sequence at the end
	{i₁->v₁,i₂->v₂,...}	specify what to use at positions
	{spec,rules}	use rules to override specifications in spec

With settings of the form , if there are more specified than items in the column, from the beginning are used for the first items, and ones from the end are used for the last items.

Settings such as Alignment, Background, and Frame can effectively be specified for individual items in the column using Item.

With the default setting ItemSize->Automatic, Column will break elements across multiple lines if necessary.

Column will not change the size of graphics or other objects that have explicit ImageSize settings.

For a column of n elements, Dividers and Spacings can specify settings for the gaps between elements, starting before the first element, and ending after the last element.

Settings for Dividers and Spacings can have the following forms:

	spec	apply spec to all gaps between items
	{spec_x,spec_y}	apply to successive horizontal and vertical gaps

The can have the same forms as for Alignment, Background and other item-oriented options.

The following settings can be used for BaselinePosition:

	Axis	axis of the middle row in the column (default)
	Baseline	baseline of the middle row in the column
	Bottom	bottom of the whole column
	Center	halfway from top to bottom
	Top	top of the whole column
	{i,pos}	position pos in element i

The settings for BaseStyle are appended to the default style typically given by the style in the current stylesheet.

Basic Examples (2)

Display as a column:

Center each element:

Display as a column:

Out[1]=

Center each element:

Out[1]=

Add a frame around the column:

Set the background:

Use alternating background colors:

Set the item size for line breaking:

Align within the column:

Change the overall background color:

Change the background color of an individual row:

Alternate the background color:

Align the column with surrounding text:

Draw all dividers:

Only draw exterior dividers:

Draw only interior dividers:

Draw custom dividers:

Use negative position indices:

Draw outer column dividers:

Use negative position indices:

Frame all elements:

Frame only the exterior:

Frame specific elements:

Set the style for the frame:

Control the size of an item and possibly force linewrapping:

By setting ItemSize the content will have a linebreak:

Change the overall style:

Change the style for a specific element:

Dynamically change the element being styled:

Dynamically change the style of a specific element:

Change the spacing between elements:

Properties & Relations (1)

Column is a special case of Grid:

GraphicsColumn Row Grid Labeled

Tables and Matrices

Grids, Rows, and Columns in Mathematica

String-Oriented Output Formats

Formatted Output

TUTORIAL COLLECTION

Grids, Rows, and Columns in Mathematica

New in 6

Ask a question about this page | Suggest an improvement | Leave a message for the team

Format: HTML | CDF