Report List Controls

BOOL IsSortable() const; // Is sort allowed?
BOOL SetSortable(BOOL bSet); // Allow/disallow sorting
BOOL IsSortAscending() const;
int GetSortedColumn() const;
// Sort a specified column.
void SortItems(int nColumn, BOOL bAscending);

m_wndList.SetSortSeparator(NULL); // Disable sort-separator
// Sort the first column in ascending order
m_wndList.SortItems(0, TRUE);

// m_wndList.SetSortSeparator(NULL); // Disable sort-separator
// m_wndList.SortItems(0, TRUE); // Sort the first column in ascending order

// Use string "Separator" as the sort-separator
m_wndList.SetSortSeparator(_T("Separator")); 
// Sort the first column in ascending order
m_wndList.SortItems(0, TRUE);

void SetCheckboxeStyle(int nStyle = RC_CHKBOX_NORMAL); // Set checkbox styles.
int GetCheckboxStyle() const;

----------------------------nStyle------------------------------------------------------------- 

• RC_CHKBOX_NONE -- No checkbox displayed
• RC_CHKBOX_NORMAL -- Normal style, multiple check marks allowed
• RC_CHKBOX_SINGLE -- Single check only. Checkboxes are mutually exclusive, just like using radio buttons.
• RC_CHKBOX_DISABLED -- Disabled, cannot be checked/unchecked by user input.

// Example:
 
// Make the checkbox read-only
m_wndList.SetCheckboxeStyle(RC_CHKBOX_DISABLED);

// Column header images
BOOL SetHeaderImage(int nColumn, int nImageIndex, BOOL bLeftSide = TRUE);
int GetHeaderImage(int nColumn) const;
CImageList* SetHeaderImageList(UINT nBitmapID, COLORREF crMask = RGB(255, 0, 255));
CImageList* SetHeaderImageList(CImageList* pImageList);

// Sub-item images
BOOL SetItemImage(int nItem, int nSubItem, int nImageIndex);
int GetItemImage(int nItem, int nSubItem) const;
CImageList* SetImageList(UINT nBitmapID, COLORREF crMask = RGB(255, 0, 255));
CImageList* SetImageList(CImageList* pImageList);
CImageList* GetImageList() const;

// Sub-item Text & Background Color
void SetItemTextColor(int nItem = -1, int nSubItem = -1, 
  COLORREF color = COLOR_INVALID, BOOL bRedraw = TRUE);
COLORREF GetItemTextColor(int nItem, int nSubItem) const;
void SetItemBkColor(int nItem = -1, int nSubItem = -1, 
  COLORREF color = COLOR_INVALID, BOOL bRedraw = TRUE);
COLORREF GetItemBkColor(int nItem, int nSubItem) const;

// Example: Set image and color for grid - 1st row 3rd column

m_wndList.SetImageList(IDB_BITMAP1); // Using bitmap resource "IDB_BITMAP1"
m_wndList.SetItemImage(0, 2, 0); // Set the 1st row 3rd column with image index 0

// Set grid colors
m_wndList.SetItemTextColor(0, 2, RGB(255, 0, 0), TRUE); // Grid text color: red
m_wndList.SetItemBkColor(0, 2, RGB(0, 255, 0), TRUE); // Grid bkground color: green

RC_ITEM_ALL - All items regardless of states
RC_ITEM_SELECTED - Selected items
RC_ITEM_UNSELECTED - Unselected items
RC_ITEM_CHECKED - Checked items
RC_ITEM_UNCHECKED - Unchecked items
RC_ITEM_FOCUSED - Focused item
RC_ITEM_UNFOCUSED - Unfocused items

int GetFirstItem(DWORD dwStates = RC_ITEM_ALL, int nStartAfter = -1) const;
int GetLastItem(DWORD dwStates = RC_ITEM_ALL, int nStartBefore = -1) const;
int GetItemCount(DWORD dwStates = RC_ITEM_ALL) const; 
DWORD GetItemStates(int nItem) const;
BOOL ExamItemStates(int nItem, DWORD dwStates) const;
BOOL SetItemStates(int nItem, DWORD dwNewStates);
int SetAllItemStates(DWORD dwOldStates, DWORD dwNewStates);
void InvertItems(int nType); // RC_INVERT_SELECTION or RC_INVERT_CHECKMARK

// Example:

// Select all items which were unselected and unchecked
m_wndList.SetAllItemStates(RC_ITEM_UNSELECTED | RC_ITEM_UNCHECKED, RC_ITEM_SELECTED);

// How many items are not checked?
int n = m_wndList.GetItemCount(RC_ITEM_UNCHECKED);

//Unselect and check all items regardless of their previous states
m_wndList.SetAllItemStates(RC_ITEM_ALL, RC_ITEM_UNSELECTED | RC_ITEM_CHECKED);

// Delete all items which were selected and checked
m_wndList.DeleteAllItems(RC_ITEM_SELECTED | RC_ITEM_CHECKED);

int MoveUp(int nItem, int nCount = 1); // Move an item upwards by "nCount" positions.

// Move an item downwards by "nCount" positions.
int MoveDown(int nItem, int nCount = 1); 

int MoveToTop(int nItem); // Move an item up to the top.
int MoveToBottom(int nItem); // Move an item down to the bottom.
int MoveTo(int nItem, int nNewPosition); // Move an item to a particular position 
BOOL SwapItems(int nItem1, int nItem2); // Swap two items including all attributes.

BOOL SetItemText(int nItem, int nSubItem, INT val);
BOOL SetItemText(int nItem, int nSubItem, UINT val);
BOOL SetItemText(int nItem, int nSubItem, LONG val);
BOOL SetItemText(int nItem, int nSubItem, ULONG val);
BOOL SetItemText(int nItem, int nSubItem, TCHAR val);
BOOL SetItemText(int nItem, int nSubItem, DOUBLE val, int nPrecision = -1);
BOOL SetItemText(int nItem, int nSubItem, 
   const COleDateTime& dateTime, 
   DWORD dwFlags = 0);

void CMyView::OnSize(UINT nType, int cx, int cy) 
{
    CFormView::OnSize(nType, cx, cy);

    // TODO: Add your message handler code here
    m_wndList.ResizeToFitParent(); // Add this line!
}

m_wndList.SetColumnHeader(_T("Student ID, 100; Enroll Date, 150; Score, 80, 2"));

    for (int i = 0; i < 10; i++)
    {
        const int IDX = m_wndList.InsertItem(0, _T(""));
        m_wndList.SetItemText(IDX, 0, rand() % 3000);
        m_wndList.SetItemText(IDX, 1, GenRandDate());
        m_wndList.SetItemText(IDX, 2, (rand() % 51) + 50);
        
        for (int j = 0; j < 2; j++)
            m_wndList.SetItemImage(IDX, j, rand() % 5); // subitem images
        
    }

    m_wndList.SetImageList(IDB_BITMAP1);
    m_wndList.SetHeaderImageList(IDB_BITMAP2);
    m_wndList.SetHeaderImage(0, 0);
    m_wndList.SetHeaderImage(1, 2, FALSE);
    m_wndList.SetHeaderImage(2, 1);
    m_wndList.SetGridLines(TRUE); // SHow grid lines
    m_wndList.SetCheckboxeStyle(RC_CHKBOX_NORMAL); // Enable checkboxes
    m_wndList.SetEditable(TRUE); // Allow sub-text edit
    m_wndList.SortItems(0, TRUE); // sort the 1st column, ascending
    m_bSortable = m_wndList.IsSortable();
    UpdateData(FALSE);
    GetDlgItem(IDC_ALLOWSORT)->EnableWindow(m_wndList.HasColumnHeader());

    // now play some colorful stuff
    
    // Set the 3rd column background color to yellow, text color to blue
    m_wndList.SetItemTextColor(-1, 2, RGB(0, 0, 0));
    m_wndList.SetItemBkColor(-1, 2, RGB(255, 255, 0));

    for (int n = 0; n < m_wndList.GetItemCount(); n++)
    {
        const int SCORE = _ttoi(m_wndList.GetItemText(n, 2)); // student score

        if (SCORE < 60)
        {
            m_wndList.SetItemBkColor(n, -1, ::GetSysColor(COLOR_INFOBK));
            m_wndList.SetItemTextColor(n, -1, RGB(255, 0, 0));
            
            m_wndList.SetItemBkColor(n, 2, RGB(255, 0, 0));
            m_wndList.SetItemTextColor(n, 2, RGB(255, 255, 255));
        }
        else if (SCORE > 90)
        {
            m_wndList.SetItemBkColor(n, -1, RGB(160, 255, 192));
            m_wndList.SetItemTextColor(n, -1, RGB(0, 0, 255));

            m_wndList.SetItemTextColor(n, 2, RGB(255, 255, 255));
            m_wndList.SetItemBkColor(n, 2, RGB(0, 160, 0));
        }
    }