Share via

  • Article

Grid.RowSpan 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 rows that child content spans within a Grid.

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

Syntax

'Declaration
See GetRowSpan, SetRowSpan

See GetRowSpan, SetRowSpan

<object Grid.RowSpan="int"/>

Property Value

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

Remarks

Dependency property identifier field: RowSpanProperty

Rows in a Grid are defined using the RowDefinition 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 two rows.

<Border Background="White" BorderThickness="5" Grid.Row="2" Grid.Column="1" Grid.RowSpan="2" >
<TextBlock TextWrapping="Wrap">
    This TextBlock spans across two rows.
</TextBlock>
</Border>

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.