Expand and Collapse Rows

• Jul 29, 2019
• 2 minutes to read

Vertical and property grid rows can have child rows. This topic describes how to collapse and expand rows in code.

How to: Expand or Collapse a Particular Row or All Rows

Use the BaseRow.Expanded property to specify whether a row is expanded or collapsed.

C#

rowPicture.Expanded = false;

VB.NET

rowPicture.Expanded = False

The image below shows how to specify the expand state in a designer.

To expand a row and all its child rows, pass the row to the VGridControlBase.FullExpandRow method.

C#

vGridControl1.FullExpandRow(rowPicture);

VB.NET

VGridControl1.FullExpandRow(rowPicture)

To expand or collapse all rows, use the VGridControlBase.ExpandAllRows and VGridControlBase.CollapseAllRows methods.

C#

vGridControl1.ExpandAllRows();

VB.NET

VGridControl1.ExpandAllRows()

How to: Expand or Collapse Specific Rows

To expand or collapse rows that meet a specific condition, enumerate rows and specify the expanded state. The following example collapses all rows except for the focused row and all its parent rows. See Tree Traversal for more details and examples.

C#

vGridControl1.RowsIterator.DoOperation(new CollapseExceptSpecifiedOperation(vGridControl1.FocusedRow));

public class CollapseExceptSpecifiedOperation : RowOperation {
   BaseRow visibleRow;
   public CollapseExceptSpecifiedOperation(BaseRow visibleRow) : base() {
      this.visibleRow = visibleRow;
   }
   public override void Execute(BaseRow row) {
      if (!row.HasAsChild(visibleRow))
         row.Expanded = false;
   }
   public override bool NeedsFullIteration { get { return false; } }
}

VB.NET

VGridControl1.RowsIterator.DoOperation(New CollapseExceptSpecifiedOperation(VGridControl1.FocusedRow))

Public Class CollapseExceptSpecifiedOperation
   Inherits RowOperation
   Dim VisibleRow As BaseRow
   Public Sub New(ByVal VisibleRow As BaseRow)
      MyBase.New()
      Me.VisibleRow = VisibleRow
   End Sub
   Public Overrides Sub Execute(ByVal Row As BaseRow)
      If Not Row.HasAsChild(VisibleRow) Then Row.Expanded = False
   End Sub
   Public Overrides ReadOnly Property NeedsFullIteration() As Boolean
      Get
         Return False
      End Get
   End Property
End Class