Click here to Skip to main content
Click here to Skip to main content

Simple Row Insert for CListCtrl

, 9 Jul 2000
Rate this:
Please Sign up or sign in to vote.
This simple CListCtrl extension allows easy row insertion when in Report mode.
<!-- STEP 2. Include download and sample image information -->

Ever been annoyed at the amount of code you need just to insert a few rows and their columns' text into a CListCtrl while using the 'Report' style?

This little MFC subclassing tutorial provides a handy little enhancement to the standard CListCtrl, which can make life easier for both beginners and not_so_beginners alike.

The code and text that follows assumes you have generated a typcal Dialog based application with the MFC Application (.exe) Appwizard in MS Visual C++.

Derive a new CListCtrl based class (here CMyListCtrl).  In the VC IDE, this is as simple as selcting 'Add Class...' from the MFC Class wizard then, in the new class dialog, naming the control and selecting CListCtrl as the base class in the drop down list.

To use the new class, start by adding a CListCtrl to the dialog (be sure to select 'Report' in the Styles page of the proprties for the new control) then, in the Member Variables page of the MFC Class Wizard (ctrl+w), add a control variable for the newly created item (IDC_LIST1, or whatever ID you supplied) - but instead of accepting the default CListCtrl as the type, you will be able to select the new CMyListCtrl type. Call the variable m_myList.

Specify

<font color="#0000FF">#include</font> "MyListCtrl.h"

in the header of the dialog class (in this case, the main dialog of the app) and you're set.

In the code that VC generates for the new class, add the following: 

<font color="#008040">// put this into the header file, in the public: section
</font><font
color="#0000FF">int</font> InsertRow(<font color="#0000FF">int</font> nPos,<font
color="#0000FF">int</font> nNoOfCols, LPCTSTR pText, ...);
//
<font color="#008040">// and this into the cpp file, in the public: section</font>
<font
color="#0000FF">int</font> CMyListCtrl::InsertRow(<font color="#0000FF">int</font> nPos,<font
color="#0000FF">int</font> nNoOfCols, LPCTSTR pText, ...)
{
    va_list argList;
    va_start(argList, pText);

    ASSERT(nNoOfCols >= 1); <font
color="#008040">// use the 'normal' Insert function with 1 argument</font>
    <font
color="#0000FF">int</font> nIndex = InsertItem(LVIF_TEXT|LVIF_STATE, nPos, pText,0,LVIS_SELECTED,0,0);
    ASSERT(nIndex != -1);
    <font
color="#0000FF">if</font> (nIndex < 0) <font color="#0000FF">return</font>(nIndex);
    <font
color="#0000FF">for</font> (<font color="#0000FF">int</font> i = 1; i < nNoOfCols; i++) {
        LPCSTR p = va_arg(argList,LPCSTR);
        <font
color="#0000FF">if</font> (p != NULL) {
            SetItemText(nIndex, i, p);    
        }
    }
    va_end(argList);
    <font
color="#0000FF">return</font>(nIndex);
}
<font color="#008040">// In your program the list control can now be filled like this:
</font>
   myList.InsertRow(0,3,_T("Sample 1"),_T("Column 2 for row 1"),_T("Column 3 for row 1"));
   myList.InsertRow(1,3,_T("Sample 2"),_T("Column 2 for row 2"),_T("Column 3 for row 2"));
   myList.InsertRow(2,3,_T("Sample 3"),_T("Column 2 for row 3"),_T("Column 3 for row 3"));
   myList.InsertRow(3,1,_T("Sample 4")); // nothing for column 2 and 3
   myList.InsertRow(4,3,_T("Sample 5"),_T("Column 2 for row 5"),_T("Column 3 for row 5"));
   myList.InsertRow(5,2,_T("Sample 6"),_T("Column 2 for row 6")); // nothing for column 3

To test, you might add a command button that executes the above code.  Also, this assumes that you have initialized the list with 3 columns - for the sake of this simple example, you might provide the following in the OnInitDialog method of the dialog class:

   <font color="#008040">// TODO: Add extra initialization here</font>
   m_myList.InsertColumn(0, "Column 1");
   m_myList.InsertColumn(1, "Column 2");
   m_myList.InsertColumn(2, "Column 3");

   m_myList.SetColumnWidth(0, 100);
   m_myList.SetColumnWidth(1, 100);
   m_myList.SetColumnWidth(2, 100);

Enjoy!

 

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

About the Author

Daniel Zuppinger
Chief Technology Officer
Switzerland Switzerland
Professional IT developer since 1983. First projects with Cobol, then Pascal, Modula2, C and since Visual C++ 1.0 also with C++. Works since 1986 as Consultant, between 1990 and 2008 for Infobrain in Switzerland, currently employed by enValue (also Switzerland).
Current field is the project management and development of software for Bank applications.
Married, two daughters, Hobbies : Paragliding, Orienteering, Mountainbiking, Photography

Comments and Discussions

 
GeneralRe: Have A Problem PinmemberAnonymous23-Oct-01 1:48 
GeneralProblem if called in other class PinsussPeter12-Jul-00 3:47 
GeneralRe: Problem if called in other class PinsussDaniel Zuppinger12-Jul-00 4:55 
Generalusing this code in an SDI app Pinmembereddiec9-Apr-02 14:15 
to use this code in an sdi app you have to:
 
1) derive a class from CDialog to handle the dialog box that contains the list control
 
2) add a variable to this class to represent the list control
 
3) override OnInitDialog so that you can initialize the list control. the way you do this is by double clicking on WM_INITDIALOG in class wizard
 
now, if you call
 
myList.InsertRow(0,3,_T("Sample 1"),_T("Column 2 for row 1"),_T("Column 3 for row 1"));
 
in the override of OnInitDialog, that works fine, it adds the line
 
but if you call
 
CMyListControlDlg aDlg;
aDlg.myList.InsertRow(0,3,_T("Sample 1"),_T("Column 2 for row 1"),_T("Column 3 for row 1"));
aDlg.DoModal();
 
you get an assertion failure whose context is:
 
CListControl::InsertItem
CMyListControl::InsertRow
 
any ideas?
 
AHWBMA
 
eddiec Smile | :)
 

GeneralRe: using this code in an SDI app PinmemberDaniel Zuppinger9-Apr-02 19:43 
GeneralRe: using this code in an SDI app PinmemberAnonymous11-Apr-02 3:10 
QuestionHow can unknow params be pass to functions... Pinsusswebguy11-Jul-00 8:23 
AnswerRe: How can unknow params be pass to functions... PinsussAnatoly Ivasyuk11-Jul-00 9:10 
AnswerRe: How can unknow params be pass to functions... PinsussDaniel Zuppinger11-Jul-00 19:53 
GeneralSuper! small, reusable snippets PinsussMartin10-Jul-00 21:00 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.140718.1 | Last Updated 10 Jul 2000
Article Copyright 2000 by Daniel Zuppinger
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid