Back to Devexpress

GridLayoutOptions.RowSpan Property

corelibraries-devexpress-dot-xtracharts-dot-gridlayoutoptions-aac012c8.md

latest5.4 KB
Original Source

GridLayoutOptions.RowSpan Property

Gets or sets the number of grid layout rows that the pane occupies.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.dll

NuGet Package : DevExpress.Charts

Declaration

csharp
[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public int RowSpan { get; set; }
vb
<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property RowSpan As Integer

Property Value

TypeDescription
Int32

The integer value that defines the number of rows that the pane occupies.

|

Property Paths

You can access this nested property as listed below:

Object TypePath to RowSpan
XYDiagramPaneBase

.LayoutOptions .RowSpan

|

Remarks

You can use the RowSpan and ColumnSpan properties to specify a pane’s weight when AutoLayoutMode is Linear. Use ColumnSpan to specify the weight when the Direction is Horizontal. Use RowSpan to specify a pane’s weight when the Direction is Vertical.

Example

This example shows how to arrange chart panes using the grid layout.

Populate the GridPaneLayout.ColumnDefinitions and GridPaneLayout.RowDefinitions collections with LayoutDefinition objects.

Use the LayoutDefinition.Weight or LayoutDefinition.SizeInPixels properties to specify the layout item’s size. Note that you should specify the LayoutDefinition.SizeMode property to define which size property is used.

Use the XYDiagramPaneBase.LayoutOptions property to access the pane layout options. Define the GridLayoutOptions.Column, GridLayoutOptions.ColumnSpan, GridLayoutOptions.Row and GridLayoutOptions.RowSpan properties to specify a pane position.

csharp
XYDiagram diagram = chart.Diagram as XYDiagram;
diagram.PaneLayout.AutoLayoutMode = PaneAutoLayoutMode.Grid;
// You can use the AddRange method to add several layout definitions to the collection.
diagram.PaneLayout.ColumnDefinitions.Add(new LayoutDefinition { SizeMode = PaneSizeMode.UseWeight, Weight = 1 });
diagram.PaneLayout.ColumnDefinitions.Add(new LayoutDefinition { SizeMode = PaneSizeMode.UseSizeInPixels, SizeInPixels = 200 });
diagram.PaneLayout.RowDefinitions.Add(new LayoutDefinition());
diagram.PaneLayout.RowDefinitions.Add(new LayoutDefinition());

diagram.DefaultPane.LayoutOptions.Column = 0;
diagram.DefaultPane.LayoutOptions.Row = 0;

diagram.Panes[0].LayoutOptions.Column = 1;
diagram.Panes[0].LayoutOptions.Row = 0;
diagram.Panes[0].LayoutOptions.RowSpan = 2;
diagram.Panes[0].LayoutOptions.ColumnSpan = 1;

diagram.Panes[1].LayoutOptions.Column = 0;
diagram.Panes[1].LayoutOptions.Row = 1;
vb
Dim diagram As XYDiagram = CType(chart.Diagram,XYDiagram)
diagram.PaneLayout.AutoLayoutMode = PaneAutoLayoutMode.Grid
' You can use the AddRange method to add several layout definitions to the collection.
diagram.PaneLayout.ColumnDefinitions.Add(New LayoutDefinition() {SizeMode=PaneSizeMode.UseWeight, Weight=1})
diagram.PaneLayout.ColumnDefinitions.Add(New LayoutDefinition() {SizeMode = PaneSizeMode.UseSizeInPixels, SizeInPixels = 200})
diagram.PaneLayout.RowDefinitions.Add(New LayoutDefinition)
diagram.PaneLayout.RowDefinitions.Add(New LayoutDefinition)

diagram.DefaultPane.LayoutOptions.Column = 0
diagram.DefaultPane.LayoutOptions.Row = 0

diagram.Panes(0).LayoutOptions.Column = 1
diagram.Panes(0).LayoutOptions.Row = 0
diagram.Panes(0).LayoutOptions.RowSpan = 2
diagram.Panes(0).LayoutOptions.ColumnSpan = 1

diagram.Panes(1).LayoutOptions.Column = 0
diagram.Panes(1).LayoutOptions.Row = 1

See Also

Pane Layout

GridLayoutOptions Class

GridLayoutOptions Members

DevExpress.XtraCharts Namespace