Partager via


Grid.ColumnSpan Attached Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets a value that indicates the total number of columns that child content spans within a Grid.

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

Syntax

'Declaration
See GetColumnSpan, SetColumnSpan
See GetColumnSpan, SetColumnSpan
<object Grid.ColumnSpan="int"/>

Property Value

Type: System.Int32
An Int32 value that represents the number of columns that child content should span. The default value is 1.

Remarks

Dependency property identifier field: ColumnSpanProperty

Columns in a Grid are defined using the ColumnDefinition element. You can span across multiple rows and columns using the Grid.RowSpan and Grid.ColumnSpan attached properties. The default value for both these properties is 1. The Grid will attempt to assign as many row spans or column spans as it can up to the amount specified by the Grid.RowSpan or Grid.ColumnSpan properties. If the position of an element is such that implementing the declared column span or row span value is untenable, the Grid will attempt to achieve the next best solution. For example, consider a 2 by 2 grid structure that has a rectangle in the position (1,1) and the rectangle is set with a Grid.ColumnSpan of 2. Since a column is not available to the right of the rectangle for such a span to be displayed, the rectangle is constrained to a single column and the rectangle's ActualWidth may be less than the Width you may have specified.

Examples

The following example displays a TextBlock that spans across three columns.

<TextBlock Margin="2" Grid.Column="0" Grid.Row="0" Grid.ColumnSpan="3"
       TextWrapping="Wrap">
This TextBlock is positioned in the first column and the 
first row (column 0, row 0) and spans across all three columns (ColumnSpan 3).
</TextBlock>

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.