Click here to Skip to main content
15,177,326 members
Articles / Desktop Programming / MFC
Posted 19 Jun 2000


71 bookmarked

Easy Navigation Through an Editable List View

Rate me:
Please Sign up or sign in to vote.
4.78/5 (16 votes)
19 Jun 2000
This article shows you how you can navigate through a multi-column, editable list view
  • Download source files - 30 Kb
  • Download demo project - 10 Kb
  • Sample Image - ListEditor.jpg


    First off, I would like to acknowledge that most of this code came from others at CodeGuru. I took code from some of the articles submitted by Zafir Anjum, so look at his article "Editable Subitems" as a basis for this article.

    This project demonstrates how the list view/control can be used to edit information in the form of a table (multiple-editable columns). I have captured the Tab, Page Down, Page Up, Up, Down, Home, and End keys to allow easy navigation through the control.

    As shown in "Editable Subitems", I subclassed the CEdit control with my class called gxEditCell. Then, I added a new parameter to it's constructor. This new parameter is a pointer to the parent list control so that my edit box could inform the list control of any important events, like a key press. Then when I get a key event, I simply tell the list control which subitem I want to edit next based off the current cell that is being edited. This can be seen in the OnKeyDown function below. As you can see, when I receive the VK_UP key event, I am telling the list control to edit the subitem located directly above the current cell. I check, of course, to see if it is a valid cell first.

    The reason I caught some events in the KeyDown, some in the KeyUp, and some in the OnChar, had to do with how the application behaved. If I would have caught the VK_PRIOR or VK_NEXT in the OnKeyDown, I would get several calls depending on how long the button was pressed. This is very annoying. If you don't believe me, move the code, add several items to the list and try it (it isn't pretty).

    I also caught the ESC key so that I could cancel an edit. The return key is being used to end an edit and when it is on the last record, it insert a new one. Just don't forget to override the OnGetDlgCode() so that you can get the arrow keys and tabs.

    gxEditCell::gxEditCell (gxListCtrl* pCtrl, int iItem, int iSubItem, CString sInitText)
    :   bEscape (FALSE)
        pListCtrl = pCtrl;
        Item = iItem;
        SubItem = iSubItem;
        InitText = sInitText;
    void gxEditCell::OnKeyDown (UINT nChar, UINT nRepCnt, UINT nFlags) 
        // Up and down are in the OnKeyDown so that the user can hold down the arrow
        // keys to scroll through the entries.
        BOOL Control = GetKeyState (VK_CONTROL) < 0;
        switch (nChar)
    		case VK_UP :
    			if (Item > 0)
    				pListCtrl->EditSubItem (Item - 1, SubItem);
    		case VK_DOWN :
    			pListCtrl->EditSubItem (Item + 1, SubItem);
    		case VK_HOME :
    			if (!Control)
    			pListCtrl->EditSubItem (0, SubItem);
    		case VK_END :
    			if (!Control)
    			int Count = pListCtrl->GetItemCount() - 1;
    			pListCtrl->EditSubItem (Count, SubItem);
        CEdit::OnKeyDown(nChar, nRepCnt, nFlags);
    void gxEditCell::OnKeyUp (UINT nChar, UINT nRepCnt, UINT nFlags) 
        switch (nChar)
    		case VK_NEXT :
    			int Count = pListCtrl->GetItemCount();
    			int NewItem = Item + pListCtrl->GetCountPerPage();
    			if (Count > NewItem)
    				pListCtrl->EditSubItem (NewItem, SubItem);
    				pListCtrl->EditSubItem (Count - 1, SubItem);
    		case VK_PRIOR :
    			int NewItem = Item - pListCtrl->GetCountPerPage();
    			if (NewItem > 0)
    				pListCtrl->EditSubItem (NewItem, SubItem);
    				pListCtrl->EditSubItem (0, SubItem);
        CEdit::OnKeyUp (nChar, nRepCnt, nFlags);
    void gxEditCell::OnChar (UINT nChar, UINT nRepCnt, UINT nFlags) 
        BOOL Shift = GetKeyState (VK_SHIFT) < 0;
        switch (nChar)
    		case VK_ESCAPE :
    			if (nChar == VK_ESCAPE)
    				bEscape = TRUE;
    		case VK_RETURN :
    			pListCtrl->EditSubItem (Item + 1, 0);
    		case VK_TAB :
    			if (Shift)
    				if (SubItem > 0)
    					pListCtrl->EditSubItem (Item, SubItem - 1);
    					if (Item > 0)
    						pListCtrl->EditSubItem (Item - 1, 2);
    				if (SubItem < 2)
    					pListCtrl->EditSubItem (Item, SubItem + 1);
    					pListCtrl->EditSubItem (Item + 1, 0);
        CEdit::OnChar (nChar, nRepCnt, nFlags);
        // Resize edit control if needed
        // Get text extent
        CString Text;
        GetWindowText (Text);
        CWindowDC DC (this);
        CFont *pFont = GetParent()->GetFont();
        CFont *pFontDC = DC.SelectObject (pFont);
        CSize Size = DC.GetTextExtent (Text);
        DC.SelectObject (pFontDC); += 5;			   	// add some extra buffer
        // Get client rect
        CRect Rect, ParentRect;
        GetClientRect (&Rect);
        GetParent()->GetClientRect (&ParentRect);
        // Transform rect to parent coordinates
        ClientToScreen (&Rect);
        GetParent()->ScreenToClient (&Rect);
        // Check whether control needs to be resized and whether there is space to grow
        if ( > Rect.Width())
    		if ( + Rect.left < ParentRect.right )
    			Rect.right = Rect.left +;
    			Rect.right = ParentRect.right;
    		MoveWindow (&Rect);
    UINT gxEditCell::OnGetDlgCode() 
        return CEdit::OnGetDlgCode() | DLGC_WANTARROWS | DLGC_WANTTAB;


    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

    Lee Nowotny
    Web Developer
    Canada Canada
    No Biography provided

    Comments and Discussions

    QuestionUsing the code in our commercial product Pin
    sangyeun1-Nov-15 15:09
    Membersangyeun1-Nov-15 15:09 
    GeneralMy vote of 5 Pin
    maplewang4-Aug-12 5:21
    Membermaplewang4-Aug-12 5:21 
    GeneralUsing the code in our commercial product Pin
    Prakash Buddhiraja11-Mar-09 14:04
    MemberPrakash Buddhiraja11-Mar-09 14:04 
    GeneralScroll Problem Pin
    MartinK29-Jun-06 2:05
    MemberMartinK29-Jun-06 2:05 
    GeneralCListCtrl Navigation Pin
    Manoj Singh K.19-Oct-04 4:52
    MemberManoj Singh K.19-Oct-04 4:52 
    GeneralCool Pin
    Patrik Svensson1-Aug-04 1:54
    MemberPatrik Svensson1-Aug-04 1:54 
    GeneralProblem with scrolling Pin
    Member 41032715-Feb-04 3:34
    MemberMember 41032715-Feb-04 3:34 
    GeneralAlignment of Rebar Pin
    Member 2224466-Dec-03 7:13
    MemberMember 2224466-Dec-03 7:13 
    Generalwhen columns over 3 Pin
    jack tian18-Jun-03 18:31
    Memberjack tian18-Jun-03 18:31 
    GeneralStrange behaviour in Win98 Pin
    Dudi Avramov18-Feb-03 21:56
    MemberDudi Avramov18-Feb-03 21:56 
    GeneralRe: Strange behaviour in Win98 Pin
    Dudi Avramov19-Feb-03 3:25
    MemberDudi Avramov19-Feb-03 3:25 
    GeneralWEW Pin
    Anonymous11-Jan-03 21:15
    MemberAnonymous11-Jan-03 21:15 
    Generalbit long.. Pin
    Bengi14-Sep-02 14:24
    MemberBengi14-Sep-02 14:24 
    GeneralRe: bit long.. Pin
    armentage27-Sep-02 8:35
    Memberarmentage27-Sep-02 8:35 
    GeneralEasy navigation - CListCtrl example Pin
    john john mackey9-Oct-01 12:28
    Memberjohn john mackey9-Oct-01 12:28 
    GeneralRe: Easy navigation - CListCtrl example Pin
    john john mackey9-Oct-01 13:03
    Memberjohn john mackey9-Oct-01 13:03 
    GeneralTab through list Control Pin
    Vineet Luktuke13-Jul-01 6:57
    MemberVineet Luktuke13-Jul-01 6:57 
    GeneralCapturing Item... Pin
    26-Jun-01 13:24
    suss26-Jun-01 13:24 
    GeneralProblems with caret's visibility Pin
    25-Mar-01 21:48
    suss25-Mar-01 21:48 
    GeneralProblems with ES_RIGHT Pin
    13-Mar-01 22:16
    suss13-Mar-01 22:16 
    GeneralRe: Problems with ES_RIGHT Pin
    DanYELL23-Jun-04 8:58
    MemberDanYELL23-Jun-04 8:58 
    GeneralEditable length Pin
    22-Nov-00 2:24
    suss22-Nov-00 2:24 

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

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