Grid Control Showing Associations

What it is:

This Grid Control (CGridCtrl) allows you to display a 2-Dimensional grid with check marks in it. It can be used to show associations of the two columns. For example the Screen Shot is a grid of NFL football teams. Each check mark represents a game which will be played. In the example app, you can change the font style and size by clicking on the Change Font button. You can add new rows and columns by inputting a name into the Name edit box and pressing the Add Row or Add Column buttons. Selecting the OK button will save the grid to a file to be loaded on the next session. Click the Cancel button to exit without saving. There is also functionality in the class to remove rows and columns, but the example application does not demonstrate it.

The Idea:

We wanted a grid which could display an ON/OFF state of two factors. In our case if a user was a member of a certain security group. The problem was that a normal grid got unnecessarily wide because there were so many columns. The idea behind this grid is to show several columns by slanting the column header text to 45 degrees. The grid control also supports Tool Tips and Serialization. So you can store the grid to a file and restore it in a later session.

How To Use:

Using the CGridCtrl class is simple. First you will need to add the CGridCtrl.h (cpp) files to your project. You might want to rebuild your class wizard database so that it knows about the new classes in your project. Add the window to your dialog by using the resource editor. Using class wizard, add a member variable for the window using the CGridCtrl class as the variable type. In the dialog's OnInitDialog method, add a calls to the control's AddColumn, AddRow and SetCheck methods to create the grid. You can also call a Serialize method to create the grid from a file. Take a look at the example application's code to see how this is done.


BOOL CGridTestDlg::OnInitDialog() 
{ 
    CDialog::OnInitDialog(); 

    // Attempt to load the grid from a previously saved File. 
    CFile fileArchive; 
    if (fileArchive.Open("GridTest.dat", CFile::modeRead)) 
    { 
        CArchive archive(&fileArchive, CArchive::load); 

        // Serialize the window state object 
        m_wndGrid.Serialize(archive); 
        archive.Close(); 
        fileArchive.Close(); 
    } 
    else // The file did not exist.  Do the default thing. 
    { 
        // Add all of the rows. 
        m_wndGrid.AddRow("Broncos", FALSE); 
        m_wndGrid.AddRow("Packers", FALSE); 
        m_wndGrid.AddRow("Dolphins", FALSE); 
        m_wndGrid.AddRow("Niners", FALSE); 
        m_wndGrid.AddRow("Cowboys", FALSE); 
        m_wndGrid.AddRow("Jets", FALSE); 
        m_wndGrid.AddRow("Redskins", FALSE); 
        m_wndGrid.AddRow("Colts", FALSE); 
        m_wndGrid.AddRow("Bucaneers", FALSE); 
        m_wndGrid.AddRow("Chiefs", FALSE); 
        m_wndGrid.AddRow("Raiders", FALSE); 

        // Add all of the columns 
        m_wndGrid.AddColumn("Broncos", FALSE); 
        m_wndGrid.AddColumn("Packers", FALSE); 
        m_wndGrid.AddColumn("Dolphins", FALSE); 
        m_wndGrid.AddColumn("Niners", FALSE); 
        m_wndGrid.AddColumn("Cowboys", FALSE); 
        m_wndGrid.AddColumn("Jets", FALSE); 
        m_wndGrid.AddColumn("Redskins", FALSE); 
        m_wndGrid.AddColumn("Colts", FALSE); 
        m_wndGrid.AddColumn("Bucaneers", FALSE); 
        m_wndGrid.AddColumn("Chiefs", FALSE); 
        m_wndGrid.AddColumn("Raiders", TRUE); 

        // 
        // NOTE: the final call to create the last column passes 
        // a TRUE value to initialize the grid and prepare it for 
        // drawing. 
        // 

        // Set the check marks passing in the row and column. 
        m_wndGrid.ToggleCheck(0, 1); 
        m_wndGrid.ToggleCheck(1, 0); 
        m_wndGrid.ToggleCheck(2, 3); 
    } 

    return TRUE;  // return TRUE  unless you set the focus to a control 
} 

CGridCtrl Manipulation (Public Methods):

virtual void Serialize(CArchive& ar)
Used to store or load a grid to/from a data file.

void Initialize()
Used to Initialize all of the drawing data used to draw the control.
(Must be done before drawing the control)

void AddColumn(CString strColumn, BOOL bReInitialize = TRUE)
Adds a new column to the grid. Reinitializes the drawing parameters if flag is set.

void AddRow(CString strRow, BOOL bReInitialize = TRUE)
Adds a new row to the grid. Reinitializes the drawing parameters if flag is set.

BOOL RenameColumn(int nIndex, CString strColumn)
Renames the column at the given index to the given string.

BOOL RenameColumn(CString strOld, CString strNew)
Renames the column with the given name to the given string.

BOOL RenameRow(int nIndex, CString strRow)
Renames the row at the given index to the given string.

BOOL RenameRow(CString strOld, CString strNew)
Renames the row with the given name to the given string.

BOOL DeleteColumn(int nIndex)
Removes the column at the given index from the grid.

BOOL DeleteColumn(CString strColumn)
Removes the column with the given name from the grid.

BOOL DeleteRow(int nIndex)
Removes the row at the given index from the grid.

BOOL DeleteRow(CString strRow)
Removes the row with the given name from the grid.

void ToggleCheck(int nColumn, int nRow)
Toggle the check mark on and off at the given column and row indexes.

BOOL IsChecked(int nColumn, int nRow)
Returns TRUE if the given column and row are checked. FALSE otherwise.

int GetNumColumns()
Returns the number of columns in the grid.

int GetNumRows()
Returns the number of rows in the grid.

void SetFontStyle(CString strFont)
Sets a new font style for text in the grid. Redraws the control.

void SetFontSize(int nHeight)
Sets a new font size for text in the grid. Redraws the control.

int GetFontSize()
Returns the size of the font used for drawing the grid.

CString GetFontStyle()
Returns the face name of the font used for drawing the grid.

Download source and demo application - 31 KB .



Comments

  • There are no comments yet. Be the first to comment!

Leave a Comment
  • Your email address will not be published. All fields are required.

Top White Papers and Webcasts

  • On-demand Event Event Date: December 18, 2014 The Internet of Things (IoT) incorporates physical devices into business processes using predictive analytics. While it relies heavily on existing Internet technologies, it differs by including physical devices, specialized protocols, physical analytics, and a unique partner network. To capture the real business value of IoT, the industry must move beyond customized projects to general patterns and platforms. Check out this webcast and join industry experts as …

  • Today's agile organizations pose operations teams with a tremendous challenge: to deploy new releases to production immediately after development and testing is completed. To ensure that applications are deployed successfully, an automatic and transparent process is required. We refer to this process as Zero Touch Deployment™. This white paper reviews two approaches to Zero Touch Deployment--a script-based solution and a release automation platform. The article discusses how each can solve the key …

Most Popular Programming Stories

More for Developers

RSS Feeds