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

A TreeList Control

, 1 Dec 1999
Rate this:
Please Sign up or sign in to vote.
A tree control / list control hybrid
  • Download demo project - 60 Kb
  • Download source files - 21 Kb
  • Sample Image - treelist.jpg

    <!-- Article Starts --> The Treelist control is a combination Tree/List control derived from CTreeCtrl.

    Here's the description of the classes that are used:

    • CTLFrame - derived from CWnd, this class is the frame class for the treelist control. It is used  to include the header control, the tree itself, and the horizontal scroll bar.
    • CNewHeaderCtrl - derived from CHeaderCtrl. Used as the header in the TreeList.

    • CNewTreeListCtrl - derived from CTreeCtrl, used as the main tree in the TreeList.

    • CTLItem - represents each item inside the tree.

    • SSortType - structure that's used to indicate whether the sort of the tree is in an ascending order or descending, and which column is being sorted.

    How to insert TreeList into your project?

    1. Insert the following files into your project:
      • TLFrame.cpp, TLFrame.h
      • NewTreeListCtrl.cpp, NewTreeListCtrl.h
      • NewHeaderCtrl.cpp, NewHeaderCtrl.h
    2. Include the file "TLFrame.h" in the app file (where the InitInstance function is) and insert the following line in the InitInstance  function:
    3. Layout a user-defined control inside the dialog into which the control is supposed to be intserted. In the class field type: "LANTIVTREELISTCTRL"
    4. Include "TLFrame.h" in the dialog's header file, and add a member variable: CTLFrame m_wndMyTreeList;
    5. In your OnInitDialog() or OnCreate() functions subclass the control:
      m_wndMyTreeList.SubclassDlgItem(IDC_TREE_LIST, this);
      // IDC_TREE_LIST is the ID of the user-defined control you 
      // inserted into the dialog</p>

    That's it !

    Using the TreeListCtrl

    The use of the control is simple. It's a tree, so treat it as one (HTREEITEM etc.). In addition, there are functions like InsertColumn, SetItemText, SetItemColor, SetItemBold, GetItemText.


    Here's my approach to implementing the TreeList. First of all, I had to create a frame window, that would include the 3 objects: header, tree, horz scroll bar. That's what CTLFrame is for. In addition, this CWnd derived class helps during the scroll: the header is clipped after it's repositioned, so there's a feeling of scrolling.

    The class CNewHeaderCtrl was created only to put the 3d triangles in it. I decided to include sorting since it's needed in 9/10 cases, and it's a shame every programmer needs to insert it by himself. Finally, CNewTreeListCtrl is the more complicated part. Every item inside the tree, has a DWORD data associated with it, that stores a pointer to a CTLItem class. CTLItem stores the information about each item- its columns' strings, whether the item is bold, the item's color, and the item data that the user wishes to associate with the item. All the functions that deal with the items, like InsertItem, DeleteItem, SetItemText etc. were overridden in order to use the CTLItem technique.

    I had some difficulties with the scrolling part, since there are many different conditions for the scroll bars: vertical scroll is shown and then the horz becomes shorter, it's hidden so the horz should become larger again; what happens if the users changed some column's size... and problems like that. I believe I handle each of these cases so I think there won't be any problems with this part.


    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

    Comments and Discussions

    Generalwhy i translate this ctrl to OCX(MFC activex)projecthave some error PinmemberLGEKS2-Jun-11 1:41 
    GeneralMy vote of 4 PinmemberMANISH RASTOGI2-Mar-11 20:18 
    GeneralNot getting notifications under VS2010 PinmemberSaintNeil9-Jun-10 13:09 
    Generaldemo is not working buddy !!!!!!!!!!!!! PinmemberS.V.RAJKUMAR18-Sep-09 0:15 
    GeneralEditlable Pinmembermarkman10115-Jul-09 1:03 
    GeneralBug in sort algorithm PinmemberFreak3027-Jan-09 0:17 
    Questionhow to insert a root element after or before an existing one PinmemberMember 217264122-Sep-08 5:24 
    GeneralUseless code Pinmemberkilt4-May-08 8:23 
    GeneralRe: Useless code PinmemberMichael O'Rourke1-Apr-09 6:02 
    GeneralI found a new bug and fixed it. Pinmembernewmetic10-Oct-07 21:55 
    GeneralBug fix for CNewTreeListCtrl::OnPaint() Pinmemberflippydeflippydebop23-Mar-07 21:53 
    GeneralRe: Bug fix for CNewTreeListCtrl::OnPaint() [modified] PinmemberKindy Chen24-Sep-07 0:14 
    GeneralMultiple Row Selection Pinmemberflippydeflippydebop23-Mar-07 21:49 
    Questionclass field type: "LANTIVTREELISTCTRL" ??? Pinmembergerms131312-Mar-07 8:02 
    GeneralSunken frame Pinmemberdgodfrey21-Feb-07 7:43 
    QuestionGood!! ... in C#? Pinmemberd00_ape11-Jul-06 21:33 
    GeneralCatching messages (e.g. TVN_GETDISPINFO) PinmemberBenGEAR16-Mar-06 3:04 
    GeneralCopyright issues to use this control Pinmemberpadmawar6-Feb-06 11:41 
    GeneralWhy a Assert failure when I use the CHeaderCtrl instead of CNewHeaderCtrl Pinmemberzhou_wz25-Aug-05 18:16 
    GeneralRe: Why a Assert failure when I use the CHeaderCtrl instead of CNewHeaderCtrl PinmemberDavid Cader7-Nov-05 9:32 
    GeneralEditLabel Pinmembermungflesh4-Aug-05 0:10 
    QuestionHow to get .NET assembly of this? PinmemberBusyMan 200530-Apr-05 3:19 
    GeneralBug in CNewTreeListCtrl::SetItemText() Pinmemberrimoraj20-Jan-05 22:41 
    Generalsplitter pane PinmemberDMW27-May-04 5:30 
    GeneralSome details if not bugs Pinmembermssg24-Dec-03 0:03 
    QuestionIDB_HEADER??? PinmemberKartan11-Sep-03 19:55 
    AnswerRe: IDB_HEADER??? PinmemberLouka Dlagnekov21-Jan-04 19:04 
    GeneralRe: IDB_HEADER??? PinmemberLouka Dlagnekov21-Jan-04 19:12 
    Generaldemo doesn't compile as-is PinmemberKartan11-Sep-03 16:54 
    QuestionResond to TVN_ITEMEXPANDING? PinmemberAndrew Sinagra9-Sep-03 15:18 
    AnswerRe: Resond to TVN_ITEMEXPANDING? Pinsussirenap10-Jul-04 16:28 
    GeneralRe: Resond to TVN_ITEMEXPANDING? PinmemberNelno21-Dec-04 6:34 
    GeneralBug in CTLFrame::OnNotify: PinsussNick Nougat14-Jul-03 10:26 
    GeneralRe: Bug in CTLFrame::OnNotify: PinmemberEric Linu14-Mar-07 16:34 
    GeneralBug in DeleteItem: Memory Leaks PinsussNick Nougat12-Jul-03 9:42 
    GeneralHorizontal Scroll bug PinmemberParampreet Sidhu8-Jul-03 1:01 
    GeneralFound a solution PinmemberParampreet Sidhu8-Jul-03 1:04 
    GeneralBug in SetItemTex() Pinmemberpaqui14-May-03 0:10 
    QuestionHow to display a vertical line on tree while sizing column headers PinmemberPaul S. Vickery3-Oct-02 2:46 
    AnswerRe: How to display a vertical line on tree while sizing column headers PinmemberOscar Londoño13-Dec-05 12:55 
    GeneralSort bug PinmemberDoug3162-Jul-02 12:13 
    GeneralRe: Sort bug PinmemberGregoire14-Jul-05 10:03 
    QuestionHow to turn into OCX PinmemberJerry Gadd21-Jun-02 6:25 
    GeneralSmall bug fix PinmemberSilent Bob30-May-02 4:45 
    GeneralRe: Small bug fix Pinmemberdours27-Jan-03 4:16 
    Generalmultiple row selection Pinmemberckdrew26-May-02 19:12 
    GeneralRe: multiple row selection Pinmemberflippydeflippydebop23-Mar-07 22:04 
    GeneralDeleteHeaders() Pinmemberdours24-May-02 1:47 
    GeneralLast Item Pinmemberdours24-May-02 1:28 
    GeneralCTLFrame::OnNotify Pinmemberdours23-May-02 6:35 

    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 | Terms of Use | Mobile
    Web04 | 2.8.150327.1 | Last Updated 2 Dec 1999
    Article Copyright 1999 by David Lantsman
    Everything else Copyright © CodeProject, 1999-2015
    Layout: fixed | fluid