ComponentOne True DBGrid for WinForms
Group Rows by the First Character of the Value
Data Presentation Techniques > Column Grouping > Column Grouping with the GroupIntervalEnum Enumeration > Group Rows by the First Character of the Value

This topic demonstrates how to use the GroupIntervalEnum.Alphabetical member in C1TrueDBGrid.

Complete the following steps:

  1. Start a new .NET project.
  2. Open the Toolbox and add a C1TrueDBGrid control to the form.
  3. Open the C1TrueDBGrid Tasks menu, click the drop-down arrow in the Choose Data Source box, and click Add Project Data Source.
  4. In the adapter's Data Source Configuration Wizard, either select a connection to C1NWind.mdb or create a new connection to this database.
  5. On the Choose your database objects page of the wizard, select all fields in the Products table and type "Products" into the DataSet name box, and then finish out the wizard.
  6. Visual Studio adds the following code to the Form_Load event:

    To write code in Visual Basic

    Visual Basic
    Copy Code
    Me.ProductsTableAdapter.Fill(Me.Products._Products)
    

    To write code in C#

    C#
    Copy Code
    this.productsTableAdapter.Fill(this.Products._Products);
    
  7. Set the DataView property to DataViewEnum.GroupBy.

    In the Designer

    In the C1TrueDBGrid Tasks menu, select GroupBy from the Data Layout drop-down.


    In Code

    Add the following code to the Form_Load event:

    To write code in Visual Basic

    Visual Basic
    Copy Code
    Me.C1TrueDBGrid1.DataView = C1.Win.C1TrueDBGrid.DataViewEnum.GroupBy
    

    To write code in C#

    C#
    Copy Code
    this.c1TrueDBGrid1.DataView = C1.Win.C1TrueDBGrid.DataViewEnum.GroupBy;
    
  8. Open the C1TrueDBGrid Designer by selecting Designer from the C1TrueDBGrid Tasks menu.
  9. Select the ProductName column by clicking on it in the right pane.

    The column can also be selected by choosing ProductName from the drop-down list in the toolbar.


  10. Set the Interval property to Alphabetical.

    In the Designer

    Locate the Interval property in the left pane of the C1TrueDBGrid Designer and set it to Alphabetical.


    In Code

    Add the following code to the Form_Load event:

    To write code in Visual Basic

    Visual Basic
    Copy Code
    ' Set the GroupInfo.Interval of the ProductName column to Alphabetical.
    Me.C1TrueDBGrid1.Columns("ProductName").GroupInfo.Interval = C1.Win.C1TrueDBGrid.GroupIntervalEnum.Alphabetical
    

    To write code in C#

    C#
    Copy Code
    // Set the GroupInfo.Interval of the ProductName column to Alphabetical.
    this.c1TrueDBGrid1.Columns["ProductName"].GroupInfo.Interval = C1.Win.C1TrueDBGrid.GroupIntervalEnum.Alphabetical;
    
  11. Finally, to keep the ProductName column visible after grouping by it, set the ColumnVisible property to True.

    In the Designer

    Locate the ColumnVisible property in the left pane of the C1TrueDBGrid Designer and set it to True.


    In Code

    Add the following code to the Form_Load event:

    To write code in Visual Basic

    Visual Basic
    Copy Code
    ' Keep the ProductName column visible while grouping.
    Me.C1TrueDBGrid1.Columns("ProductName").GroupInfo.ColumnVisible = True
    

    To write code in C#

    C#
    Copy Code
    // Keep the ProductName column visible while grouping.
    this.c1TrueDBGrid1.Columns["ProductName"].GroupInfo.ColumnVisible = true;
    

In this example, the ProductName column is grouped by the first letter of the product name.


See Also