Grid.ColumnDefinitions Property

Gets a ColumnDefinitionCollection defined on this instance of Grid.

Namespace:  System.Windows.Controls
Assembly:  System.Windows (in System.Windows.dll)

Syntax

'Declaration
Public ReadOnly Property ColumnDefinitions As ColumnDefinitionCollection
public ColumnDefinitionCollection ColumnDefinitions { get; }
<Grid>
  <Grid.ColumnDefinitions>
    oneOrMoreColumnDefinitions
  </Grid.ColumnDefinitions>
</Grid>

XAML Values

  • oneOrMoreColumnDefinitions
    One or more ColumnDefinition elements. Each such ColumnDefinition becomes a placeholder representing a column in the final grid layout.

Property Value

Type: System.Windows.Controls.ColumnDefinitionCollection
A ColumnDefinitionCollection defined on this instance of Grid

Remarks

The ColumnDefinitionCollection contains the ColumnDefinition objects that define each column of the grid available for positioning elements.

If a child element is added to a column within a Grid, and the column has its Width property set to Auto, the child will be measured without restrictions. This behavior can prevent horizontal scroll bars from displaying if a ScrollViewer is being used, as the child element is measured as unbounded. For purposes of display, the child is clipped instead of scrolled.

When setting this property in XAML, do not include an explicit ColumnDefinitionCollection object element. Instead use implicit collection syntax. For more information, see the Remarks section in ColumnDefinitionCollection.

NoteNote:

By default, a grid contains one row and one column.

Examples

The following example creates a Grid with two columns using ColumnDefinitions.

<Grid.ColumnDefinitions>
    <ColumnDefinition Width="250" />
    <ColumnDefinition Width="150" />
</Grid.ColumnDefinitions>

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.