CBCGPGridCtrl

Detailed Description

The CBCGPGridCtrl class implements the functionality of a grid control that displays the hierarchical list of editable items. Each item can represent various types and contain sub-items.

A Grid Control object holds a list of CBCGPGridRow objects that represent a grid row. Each row is built up from CBCGPGridItem objects.

The Grid control provides yo with the following features:

• Unlimited number of items in a row
• Sorting by a single column
• Sorting by multiple columns
• Ability to add or remove columns on the fly
• In-place editing of item data
• Support for custom data types
• Single and multiple row selection
• Single and multiple item (grid cell) selection
• Copy selection to the Clipboard
• Grouping by single or multiple columns (this feature is essential for reports)
• "Group By" box
• Virtual Mode
• Printing support
  • The grid control support direct printing and printing with the Document/View framework.
  • Use CBCGPGridCtrl::Print function to print a grid control on the user selected device.
  • Use the CBCGPGridView class for printing via the Document/View framework.
  • Override CBCGPGridCtrl::OnPrintPageHeader or CBCGPGridCtrl::OnPrintPageFooter to print header and footer.

See also

CBCGPGridView, CBCGPGridRow, CBCGPGridItem

The following code illustrates how to begin using the Grid control in application:

Copy

// construct the Grid object

CBCGPGridCtrl m_wndGrid;

// Create the Windows control and attach it to the Grid object

m_wndGrid.Create(WS_CHILD | WS_VISIBLE | WS_BORDER, rectGrid, this, IDC_GRDID);

// Insert columns:

m_wndGrid.InsertColumn(0, _T("Column 1"), 100);

m_wndGrid.InsertColumn(1, _T("Column 2"), 100);

m_wndGrid.InsertColumn(2, _T("Column 3"), 100);

m_wndGrid.InsertColumn(3, _T("Column 4"), 100);

const int nColumns = m_wndGrid.GetColumnCount();

// Insert 10 rows:

for (int nRow = 0; nRow < 10; nRow++)

{

// Create new row:

CBCGPGridRow* pRow = m_wndGrid.CreateRow(nColumns);

// Set each column data:

for (int nColumn = 0; nColumn < nColumns; nColumn++)

{

long lValue = (nColumn + 1) * (nRow + 1);

pRow->GetItem(nColumn)->SetValue(lValue);

}

// Add row to grid:

m_wndGrid.AddRow(pRow, FALSE /* Don't recal. layout */);

}

m_wndGrid.AdjustLayout();