FIX: CListCtrl::InsertColumn() Causes Column Data to Shift

Retired KB Content Disclaimer

View products that this article applies to.

This article was previously published under Q151897

SYMPTOMS

After adding items to a CListCtrl, if you call InsertColumn() to add additional columns, column data starting from the second column will be shifted right. For example, if you initially create two columns and add your items, adding a third column will cause the data from the second column to disappear and reappear in the third column. You may need to force a repaint (minimize the window and restore it) to see the changes.

Back to the top

CAUSE

This is a bug in the Listview control. Sending an LVM_INSERTCOLUMN after data has already been inserted, causes this problem.

Back to the top

RESOLUTION

There are several ways to work around this problem:

Back to the top

Method #1

Use LPSTR_TEXTCALLBACK in the call to InsertItem(). This will cause a notification LVN_GETDISPINFO to be sent to the parent of the CListCtrl each time the text for each item is needed. The handler for this notification will then fill in the appropriate text for each item.

Back to the top

Method #2

Create all the columns up front before adding any items. You can hide columns by setting their initial width to zero in the call to InsertColumn(). To show columns, you can call SetColumnWidth() or SetColumn(). The only drawback to this method is that the user can still resize the column by dragging in the header control.

Back to the top

Method #3

Reset the contents of the CListCtrl via DeleteAllItems() and add all column data again after calling InsertColumn().

Back to the top

STATUS

Microsoft has confirmed this to be a problem in the Microsoft products listed at the beginning of this article. This bug has been fixed in COMCTL32.DLL which as been released with Microsoft Windows NT 4.0 and Microsoft Internet Explorer 3.01.

Back to the top

MORE INFORMATION

Sample Code

Back to the top

Method #1


   // m_pList is of type CListCtrl*
   BEGIN_MESSAGE_MAP(CTestView, CView)
        ON_NOTIFY (LVN_GETDISPINFO, IDC_LIST, OnGetDispInfo)
   END_MESSAGE_MAP()

      int CTestView::OnCreate(LPCREATESTRUCT lpCreateStruct)
      {
          // create CListCtrl and columns
      ...
          // insert item; text will be set in LVN_GETDISPINFO
          m_pList->InsertItem (iIndex, LPSTR_TEXTCALLBACK);
      ...
      }

      void CTestView::OnGetDispInfo (NMHDR* pnmhdr, LRESULT* pResult)
      {
          LV_DISPINFO* pdi = (LV_DISPINFO *) pnmhdr;

          // set text for column #1
          if (0 == pdi->item.iSubItem)
              pdi->item.pszText = "1st Column Data";
          // set text for column #2
          else if (1 == pdi->item.iSubItem)
              pdi->item.pszText = "2nd Column Data";
          // set text for column #3
          else if (2 == pdi->item.iSubItem)
              pdi->item.pszText = "3rd Column Data";
      }

Back to the top

Method #2

   int CTestView::OnCreate(LPCREATESTRUCT lpCreateStruct)
   {
       // create CListCtrl and columns
       ...
       // create 3rd column with zero width so it is not visible
       m_pList->InsertColumn (2, "", LVCFMT_LEFT, 0);
       // add items
       ...
       return 0;
   }

   // this function makes the 3rd column appear
   void CTestView::AddColumn()
   {
       LV_COLUMN lvc;

       lvc.mask = LVCF_TEXT | LVCF_WIDTH;
       lvc.cx = 100;
       lvc.pszText = "Column #3";
       // set the text and width of column #3
       m_pList->SetColumn (2, &lvc);
   }

   /* Compile options needed: default
   */

Back to the top

APPLIES TO

Microsoft Foundation Class Library 4.2, when used with:

Microsoft Visual C++ 4.0 Standard Edition
Microsoft Visual C++ 4.1 Subscription
Microsoft Visual C++ 4.2 Enterprise Edition
Microsoft Visual C++ 4.2 Professional Edition

Back to the top

kbbug kbfix kblistview kbuidesign kbvc500fix KB151897

Back to the top

Retired KB Content Disclaimer

This article was written about products for which Microsoft no longer offers support. Therefore, this article is offered "as is" and will no longer be updated.

Back to the top