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.


<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
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>
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>
color="#0000FF">int</font> nIndex = InsertItem(LVIF_TEXT|LVIF_STATE, nPos, pText,0,LVIS_SELECTED,0,0);
    ASSERT(nIndex != -1);
color="#0000FF">if</font> (nIndex < 0) <font color="#0000FF">return</font>(nIndex);
color="#0000FF">for</font> (<font color="#0000FF">int</font> i = 1; i < nNoOfCols; i++) {
        LPCSTR p = va_arg(argList,LPCSTR);
color="#0000FF">if</font> (p != NULL) {
            SetItemText(nIndex, i, p);    
<font color="#008040">// In your program the list control can now be filled like this:
   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);




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

GeneralPreventing auto resize in a CListCtrl Pinmemberparatracker4-Jun-08 3:41 
GeneralCListCtrl Item Number reorder. Pinmemberchuck5511-Apr-08 8:30 
QuestionHow to add items in list control(Multicolumn)? PinmemberArum M S26-Jul-06 20:42 
QuestionCListCtrl PinmemberArum M S26-Jul-06 20:25 
GeneralSimple problem, please help Pinmemberhaiaw12-Sep-04 23:42 
Generalcan't retrieve subitem text Pinmemberpolonskyg23-May-04 11:58 
GeneralDifferent width for different row and column place PinmemberL. Naga Prasad19-May-04 4:05 
Questionhow to show multilanguage using SetItemText? Pinmembercheonyong2-May-04 19:11 
I want to show Korean, Chinese and Japanese using
BOOL SetItemText( int nItem, int nSubItem, LPTSTR lpszText );
I could show English but other than english it shows strange words.
please give me a hint if you know any.
Thank you.
AnswerRe: how to show multilanguage using SetItemText? Pinmembermanuchadha6-Jan-05 19:31 
QuestionHow to limit the number of columns in a List Control Pinmemberpandey_sachin26-Jan-04 2:13 

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
Web03 | 2.8.141015.1 | Last Updated 10 Jul 2000
Article Copyright 2000 by Daniel Zuppinger
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid