ComponentOne True DBGrid Pro 8
Tutorial 25 - Outlook-Style Grouping

In this tutorial, you will learn how to use the Outlook-Style Grouping feature.

The purpose of outlook-style grouping is to allow you to move grid columns into a new split for enhanced data display capabilities. When in Group mode, a "grouping area" is added to the grid, providing an intuitive interface for creating a columns group.

When DataView is set to 2 - Group, and AllowColMove is set to True, the grid will support the ability to group columns into the grouping area. This action can be performed by users at run time by selecting a column and dragging its header into the grouping area. This action can also be performed in code at run time by invoking the Add method of the GroupColumns collection. Use the Remove method of the GroupColumns collection at run time to remove a column from the grouping area.

See Outlook-Style Grouping for more information.

Note: The DataView property is only supported by the OLE DB version of True DBGrid.

1.   Start a new project.

2.   From the Visual Basic Project menu, select Components, then check the boxes labeled ComponentOne True DBGrid Pro 8.0 (OLEDB) and Microsoft ADO Data Control 6.0 (OLEDB).

3.   Place an ADO Data control (Adodc1) and a True DBGrid control (TDBGrid1) on the form (Form1.)

4.   Display the custom property pages for Adodc1. Click the General tab and select the Use Connection String option. Click Build. The 'Microsoft OLE DB Provider for ODBC Drivers option should be highlighted. Click Next. Enter the datasource name (TDBGDEMO.MDB) in the Use Data source name text box. You do not have to enter a user name or password. Test the connection to make sure it works. Close the dialog window.
Click the OK button to close the property page.

5.   Set the CommandType property to 2 - adCmdTable.

6.   Set the RecordSource property to Composer.

7.   Set the DataSource property of TDBGrid1 to Adodc1.

8.   Set the AllowAddNew and AllowDelete properties of TDBGrid1 to True (note that the default value of AllowUpdate is True).

9.   Set the DataView property of TDBGrid1 to 2 - Group

10.  Open the Property Pages dialog. Select the Splits property page by clicking the Splits tab. Expand the Splits(00) object and set the AllowColMove property to True. Click the OK button at the bottom of the property page dialog to accept the changes. You have now finished configuring the grid. The grid should look like the one in the following figure.

11.  Add the following code to GroupColMove event of TDBGrid1:

Example Title
Copy Code
Private Sub TDBGrid1_GroupColMove(ByVal Position As Integer, ByVal ColIndex As Integer, Cancel As Integer)


    Dim strSort As String

    Dim Col As TrueOleDBGrid80.Column


    ' Loop through GroupColumns collection and construct the sort string for

    ' the Sort property of the Recordset.

    For Each Col In TDBGrid1.GroupColumns

        If strSort <> vbNullString Then

            strSort = strSort & ", "

        End If

        strSort = strSort & "[" & Col.DataField & "]"

    Next Col



    Adodc1.Recordset.Sort = strSort

End Sub

Run the program and observe the following:



Copyright (c) GrapeCity, inc. All rights reserved.

Product Support Forum  |  Documentation Feedback