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

ToDoList 6.9.6 - An effective and flexible way to keep on top of your tasks

, 28 Feb 2015 Eclipse
Rate this:
Please Sign up or sign in to vote.
A hierarchical task manager with native XML support for custom reporting.


3rd Party

Note: Please contact the respective authors directly with comments and questions



Latest Update (6.9 Feature Release)

  • New Web Updater (Help > Check for Updates)
  • New Uninstaller (Help > Uninstall)
  • New iCal Importer (Tools > Import Tasks)
  • New Analysis of 'Tracked Time' (Tools > Analyse Tracked Time)
  • New integrated UI for selecting column/edit field/filter field visibility (View > Task Attribute Visibility)
  • Added 'Type' (tracked/adjusted) column to log file
  • Added task path to time-track log file
  • Added task 'Path' to Find Tasks dialog
  • Added support for 'pasting' import from clipboard
  • Added support for multi-selection custom icon attributes
  • Added 'Select in Explorer' to Tools menu and file tab context menu
  • Added preferences to control the visibility of tabbed 'views'
  • Added preference for specifying trailing text after pasting date/time
  • Added option to specify start/due filter dates
  • Added 'Number of Recurrences' to recurring tasks.
  • Added messagebox if QuickFind does not find text
  • Added menu command to select all references of a task
  • Added menu command to goto 'Real' task from reference
  • Added history combo to 'Title' field of transform, print/preview dialogs
  • Added drag'n'drop support for re-ordering tabs
  • Added optional confirmation dialog to time tracking
  • Added close buttons to tasklist tabs
  • Added blank line to single-selection droplists

And much, much more.


You know how it is - you start work on one project and halfway through, you find one or two side-projects crop up that have to be solved before you can continue on the original project.

This is one such project with the added twist that it too started its life as a side-project. Here's what happened:

<Cue wavy screen effect>

I can only imagine that the planets must have been in (mis-)alignment or something, because at one point a few months ago, I was suddenly fielding emails on four or five separate articles I had previously submitted to CodeProject, some asking for features and others for bug fixes.

Foolishly or otherwise, I largely agreed with all the points raised, and subsequently found myself with fourteen or fifteen separate issues to resolve.

The situation was also made worse because I was trying to use CodeProject to keep track of all the things I had agreed to do, meaning that I had to continuously trawl the comments section of each article to remind myself of what I was supposed to be working on.

It even got to the stage where I was worrying that I'd fail to deliver on something - silly I know, but there you are!

Keeping a list on paper was a definite step in the right direction, but since I do all my coding on the same machine, it seemed somewhat inelegant, and anyway, we all know what happens to crucial bits of paper left lying around on desks and such.

The next step was to hunt around on the web for a tool to meet the following requirements:

  • Simple interface
  • Support for hierarchical data
  • Numbered items/subitems
  • Open file format
  • Freeware

Simple, huh! not!

I will admit that I did not spend weeks searching, but I am still surprised at the general lack of software matching my needs.

On reflection, I think that the reason may be simple: people are so used to commercial software being 'feature-rich' that when they come to design software themselves, they (not unreasonably) think they too need to cram as much in as possible, often leading to software where a lot of essential functionality is hidden away in the menu bar.

So, surprise, surprise, I decided to write something myself.

However, it's fair to say that I did not originally intend to post it on CodeProject and am only really doing so because I had a heap of fun solving some very interesting problems and these are what I think make it worth it.

Using the Software

There's really very little I need to say here since every feature/function is explicitly visible in the interface.

Nevertheless, the following list of basic capabilities and omissions may go someway to answering any questions that arise:

  • Files are stored in XML format with .xml file extension.
  • Trying to load a non-tasklist file will generally fail (unless you read the code to see how to circumvent it).
  • The number of items/subitems is limited only by memory (although performance may be the deciding factor before you exhaust memory).
  • Marking a parent item as 'done' will also gray-out child items, but they are not disabled or automatically marked as 'done'.
  • An ellipsis (...) indicates that an item has sub-items.
  • All items can be expanded or collapsed (by double-clicking).
  • Top-level items and sub-items are created using different toolbar buttons.
  • There are task-specific context-menus.
  • The previously open tasklists are re-opened on startup.
  • The tasklist is automatically saved when closing the software or minimizing it to the system tray.
  • The priority of a task is shown as a grayscale box to the left of the item.

Points of Interest

Here's where we come to the side-projects I was talking about, the first two of which I intend to work up into follow-up articles.

They are:

  1. The 'ordered' tree control, which incorporates a non-client gutter for displaying the item numbers.

    The idea stemmed from research I did into alternative designs for a tree-list control, which did not solve it by creating a hybrid control incorporating a tree and a list.

    The hybrid control seems such an obvious solution that I suspect few people have stopped to question it, but it has still always struck me as looking far too much like hard work to be truly elegant ('square pegs' and 'round holes' spring to mind).

    One possible idea is to implement the 'list' portion entirely in the non-client area of the tree. I.e., shift the right hand client edge to the left and then render the list portion in the resulting non-client area.

    Whilst I've yet to get round to building a proof of concept, it was nevertheless this ongoing mental debate which prompted me to try to solve the requirement for numbered items and subitems by rendering the item/subitem numbers in the non-client area.

    Without going into too much detail (as this will subsequently be an article of its own), this is how I got it to work:

    • Handle TVM_INSERTITEM and TVM_DELETEITEM to know exactly when items are added and removed.
    • In these handlers recalculate the width of the gutter required to display the widest 'dotted' item/subitem number. (Note: this is not necessarily simply the deepest subitem.)
    • If the required gutter width changes, call SetWindowPos(NULL, 0, 0, 0, 0, SWP_FRAMECHANGED | SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER) to force Windows to recalculate the non-client area of the control.
    • Handle WM_NCCALCSIZE when it does, and offset the left border by the required gutter width.
    • Handle WM_NCPAINT for painting the numbers.

    This is necessarily an over-simplification, but it captures the essence of the solution, and all that essentially remains is lots of fiddling about to ensure the non-client area gets redrawn at the the right times to stay synchronized with the client area.

  2. Embedding .RC control definition data directly in a .cpp file to break the dependency on binary resources (a.k.a. 'Runtime Dialogs').

    This is an idea that has been floating about for quite some time and which has only recently gelled into a workable solution.

    The problem, put simply, is that if you want to take advantage of the resource editor in Visual Studio (and who doesn't), then you very quickly find yourself stuck with having to load dialog templates from resources compiled into the binary file.

    This further means that if you want to make use of a dialog across multiple projects, then either you need to copy and paste the dialog template between project .RC files, or you need to build the dialog into a DLL from which it can be accessed.

    'Runtime Dialogs' (a snappy title I coined myself) is a solution that neatly sidesteps both the nuisance of copying dialog resources between resource files and the extra work (and maintenance) involved in packaging dialogs in DLLs.

    And it works like this:

    • First, you design your dialog template in the resource editor, create a CDialog derived class using class wizard, and wire up all the controls just as you normally would.
    • Next, you #include "runtimedlg.h" and change all instances of CDialog to CRuntimeDlg.
    • Then, you cut and paste the control definition section from the appropriate section in the .RC file and embed it directly in the dialog's .cpp file as a static string (with a bit of tweaking to handle double quotes and such like).
    • Finally, in the constructor of your dialog, you simply call CRuntimeDlg::AddRCControls(...) passing the control definitions as a string.
    • And CRuntimeDlg takes care of the rest including, if required, auto-sizing the dialog to suit the control layout.

    I'm certainly not suggesting that this is a 'win-win' solution for all situations but it certainly has merits in its closer coupling of dialog template to dialog code which makes sharing dialogs across multiple projects a breeze.

    P.S.: In case it's not clear here, I used CRuntimeDlg to create CToDoCtrl which encapsulates the ordered tree together with the priority, date and comments controls as a single simple-to-instantiate control.

    I'm also proposing to use them in the .NET port of my ProjectZip add-in for VC6.

  3. Embedding the XML file in a web page.

    This is possibly the most satisfying aspect of the whole project because it was completely unexpected.

    What I mean is that, until recently, my knowledge of DOM and XMLDOM was virtually non-existent, as it's only since I've become more interested in the presentation of AbstractSpoon that I've been forced to get to grips with the various implementations of DOM and XMLDOM out there.

    I'm pleased to say that the code on my site works under IE 6.0, Netscape 7.1, and Mozilla, although custom code was required to achieve this.

Generic MFC Classes that may prove Useful to You

The following table lists a wide range of utility classes written for this project. They can all be included in any MFC project provided you include any class dependencies too. Feel free to ask any questions relating to these specific classes and how to use them.

Class Name


Class Dependencies
(apart from MFC)


Customizable "About…' dialog not requiring a dialog resource. Supports html encoded text

CRuntimeDlg, CRCCtrlParser


Adds only unique items to the drop list and shuffles the list so that the last added item is at the top



Encapsulates the setting and unsetting of a boolean variable thru the lifetime of the class instance



Non-ownerdraw button that displays the selected colour on the button face and displays the colour dialog when clicked



Owner-draw combobox for displaying and selecting user defined colours



Encapsulation of various rountines for calculating date spans and for formatting



Encapsulation of the Win32 API



Re-implementation of the CDialog DDX/DDV rountines to avoid the MFC error messages when the user clears a number edit (for instance)



Encapsulates the MapDialogRect Win32 API



Class for managing the docking of one popup window to another.

*CSubclassWnd, CHoldRedraw, CAutoFlag


Encapsulates various rountines for querying about drives, files and disk space



Adds support to CBitmap for loading non-bmp files and resources.


CEnBitmapEx, CColorReplacer, CImageBlurrer, CImageColorizer, CImageContraster, CImageEmbosser, CImageFlipper, CImageGrayer, CImageLightener, CImageNegator, CImageResizer, CImageRotator, CImageSharpener, CImageShearer, CImageSysColorMapper, CImageTinter

Adds image manipulation funationality to CEnBitmap



Adds saving and restoring of custom colours to CColorDialog



Adds functions for extracting and querying commandline switches



Adds user-defined button capabilities to CEdit

CMaskEdit, CThemed, CDlgUnits


Adds support for using alternative resource or file images



Adds buttons for browsing and displaying the file represented by the text in the edit control. Also shows the file's small icon.

CEnEdit, CFolderDialog, CMaskEdit, CDlgUnits, CThemed, CSysImageList


Encapsulates WM_SETREDRAW



Fixes a number of behavioural problems including the handling of certain keypresses



Tracks the cursor movement over user-defined windows and posts event messages as necessary



Provides simple method to detect if another instance of an app is running



Adds simple character masking to CEdit



Allows the UI of standard windows controls to be extended by supporting any number of columns to be added to the non-client area of the window. Favours tabular controls like lists, trees, etc

*CSubclassWnd, CHoldRedraw, CThemed, CDlgUnits


CTreeCtrl implementation of CNcGutter displaying a single column showing the hierarchical position of each tree item in '' notation.

CHoldRedraw, CThemed


Very simple password dialog not requiring a dialog resource

CRuntimeDlg, CRCCtrlParser


Simpler replacement for CPropertySheet allowing easier creation as a child window



Used by CRuntimeDlg for parsing dialog resource-like text



Adds support to CDialog for building dialogs at runtime ie. dialogs do not require a dialog resource



Class for handling application keyboard shortcuts.

*CSubclassWnd, CWinClasses


Spellcheck dialog not requiring a dialog resource, which interfaces with ISpellCheck (interface to Open Office dictionaries)

CRuntimeDlg, CRCCtrlParser, ISpellCheck


Encapsulates the Windows system image list (file/folder images)



Adds post rendering callback for the tabs without using owner-draw



Encapsulates themed (XP) and non-themed (the rest) drawing of windows controls



Adds a button for specifying time units and provided routines for converting time to and from different time units

CEnEdit, CMaskEdit, CThemed, CDlgUnits


Adds support for dialog toolbar tooltips, multiline tooltips and dropbuttons with menus

*CSubclassWnd, CEnBitmap, CEnBitmapEx


Encapsulates the Shell_NotifyIcon Win32 API. Also provides balloon tips and animation



Adds support for recognizing urls, clicking them and setting custom url callbacks



Encapsulates the ::GetClassName Win32 functions


CXmlFile, CXmlItem

Non-Unicode class for reading and writing xml files



Adds encryption capabilities to CXmlFile

CXmlFile, IEncryption

* CSubclassWnd was originally written by Paul DiLascia for MSJ magazine. The version I use has been heavily extended to suit my specific needs. The classes that depend on it here need this extended version.

Further Work

Whilst this tool was originally intended for my personal use only, it is now a 'community' project, so if you find it useful and want to make suggestions for enhancements or bug fixes, then post below.


  • 6.9.6 (01 Mar 2015)
    • Fixed Gantt View editable state not being refreshed on check-in
    • Fixed export to '.tdl' to only add a file link to the top-level task
    • Fixed erroneous task dependencies when exporting to '.tdl'
    • Fixed CTimeEdit to show correct units menu selection
    • Added '-i8' commandline switch for pasting richedit images as 8bit to reduce size
    • Added support for bumping task dates from commandline (-sd, -dd, -cd)
    • Added support for use of shift key to force Outlook links to use GUIDs
    • Added logging to ini file initialisation
    • Updated 'Resources\Translations\German.csv, YourLanguage.csv'
    • Updated 'Resources\Stylesheets\tgEstimatesAndActuals_eng.xsl'
    • Removed 'Path' from print preview attribute list
  • 6.9.5 (07 Feb 2015)
    • Fixed tree-view line size bug with 'user font' specified
    • Fixed encoding of source code workspace and project files
    • Fixed 'TimeEst/Spent' keyboard shortcuts to use translated text
    • Fixed incorrect handling of 'C, V, X' in 'TimeEst/Spent' fields
    • Fixed differences between 'Other Task Attributes' context-menu text and what is shown in preferences keyboard shortcuts
    • Fixed various 'Multi-instance' bugs
    • Fixed 'Debug' menu appearing in keyboard shortcut preferences
    • Fixed message box infinite-loop when too little space to save tasklist
    • Fixed incorrect appearance of ParentID when exporting
    • Updated French translation 
    • Saved folder location in 'Analyse logged time' dialog
    • Removed duplicate strings from 'YourLanguage.csv'
  • 6.9.4 (27 Jan 2015)
    • Fixed failing backup when not enough disk space
    • Fixed font display of 'Find Tasks' results
    • Fixed startup code to better handle when 'Multiple Instances' is enabled
    • Fixed bug in 'Colour' field visibility 
    • Removed time component from 'Created' column
    • Removed spurious extra separator in rich text toolbar
    • Automatically refresh 'Find Tasks' after changing the options droplist
    • Added simple column-header sorting to 'Find Tasks' results
    • Updated French translation
    • Minor changes to 'YourLanguage.csv' (Affects translators)
  • 6.9.3 (20 Jan 2015)
    • Fixed bug entering quoted text in QuickFind droplist
    • Fixed sorting of new 'Find' filters in 'Show' droplist
    • Fixed spurious characters apearing when pasting rich text from GMail (and Thunderbird)
    • Fixed 'View > Collapse > All tasks' not correctly setting the selection
    • Fixed missing keyboard shortcuts for all user-defined tools
    • Added '-y' commandline switch to export csv as UTF-8
  • 6.9.2 (31 Dec 2014)
    • Added '-z' commandline switch to save attribute visibility settings in tasklist
    • Fixed initial scaling bug when first switching to Statistics view
    • Fixed bug preventing dragging of vertical comments splitter
    • Fixed ordering of csv-exported custom attributes
    • Comments hyperlinks no longer created if protocol is followed by a space
    • ToDoList no longer brought to foreground when setting a task attribute from commandline
    • Text is now appended to task comments when set via the commandline (-cm)
  • 6.9.1 (19 Dec 2014)
    • Fixed Calendar display bug when task start date is removed
    • Fixed Combobox scroll selection bug when scrollbar is visible
    • Fixed Window menu tasklist name formatting
    • Fixed GanttProject import/export encoding bug
    • Fixed translation bug when app is maximised
    • Fixed tasklist tab width after restoring multiple tasklists on startup when first tasklist is active tab
    • Fixed spell checking not working on task title
    • Fixed loss of selection after refiltering
    • Fixed various commandline bugs
    • Fixed calendar not updating when recurring daily task is completed
    • Fixed menu sort state no longer updating once 'Multi-sort' has been enabled
    • Fixed rich text comments link crash 
    • Added logging to investigate Outlook-related issue
  • 6.9 Feature Release (02 Dec 2014)
    • New Web Updater
    • New Uninstaller
    • New iCal Importer
    • New Analysis of 'Tracked Time'
    • New integrated UI for selecting column/edit field/filter field visibility
    • Added 'Type' (tracked/adjusted) column to log file
    • Added task path to time-track log file
    • Added task 'Path' to Find Tasks dialog
    • Added support for 'pasting' import from clipboard
    • Added support for multi-selection custom icon attributes
    • Added 'Select in Explorer' to Tools menu and file tab context menu
    • Added preferences to control the visibility of tabbed 'views'
    • Added preference for specifying trailing text after pasting date/time
    • Added option to specify start/due filter dates
    • Added 'Number of Recurrences' to recurring tasks.
    • Added messagebox if QuickFind does not find text
    • Added menu command to select all references of a task
    • Added menu command to goto 'Real' task from reference
    • Added history combo to 'Title' field of transform, print/preview dialogs
    • Added drag'n'drop support for re-ordering tabs
    • Added optional confirmation dialog to time tracking
    • Added close buttons to tasklist tabs
    • Added blank line to single-selection droplists
    • Added support for importing to new tasklist when active tasklist is read-only
    • Added blank line to csv importing from clipboard
    • Added support for expanding environment variables in file links
    • Added 'timer' icon to tasklist tab when tracking time
    • Added mouse-wheel scrolling to tab and spin controls
    • Added selection colour around datetime checkboxes when they have the focus
    • Added support for Unicode display of 'Stickies'
    • Added [Ctrl+Alt+C] Shortcut to 'Copy As HTML' in Comments
    • Added parent task IDs when printing from list view
    • Added support to log analysis for negative times
    • Added initial support for RTL languages (work in progress)
    • Added mouse-delete support to auto-droplists
    • Added support for user to add zero times to log file
    • Added support for in-place editing of Gantt task titles
    • Added theming to preference dialog
    • Added support for controlling time visibility in columns
    • Added 'Weekdays' to 'Offset Task Dates' dialog
    • Implemented auto-scrolling to preference sub-sections
    • Selected tab text displayed in bold when theming enabled
    • Logs files now backed up when backing-up tasklists
    • Created 'Copy As Html' as separate rich text comments command
    • Changed task log file to display as readonly so Excel does not lock it
    • Moved 'Edit Task Log File' to 'Tools' menu and rename to 'View Task Log File'
    • Improved drag'n'drop of Outlook items
    • Improved 'Insert Horizontal Line' in rich text comments
    • Improved Burndown rendering performance
    • Improved performance in Gantt view
    • And heaps of fixes
  • 6.8.10 (22 Feb 2014)
    • Changed default reminder action to 'Snooze'
    • Fixed monthly recurring task reuse
    • Fixed problem with transformation of comments
  • 6.8.9 (11 Feb 2014)
    • Fixed task 'positions' not updating on 'New/Delete Task'
    • Incremented tasklist format version to protect against older versions of ToDoList
    • Fixed filtering when combining 'Hide completed tasks' and 'Show all subtasks'
  • 6.8.8 (25 Jan 2014)
    • Fixed rich-text comments not being transformed
    • Fixed reminder snooze values not being saved
    • Recalculated Burndown date range when a task's date changes
    • Removed disabled custom attributes from sort menu
    • Stabilised sorting of 'equal' tasks
  • 6.8.7 (19 Jan 2014)
    • Fixed crash opening tasklists from Explorer
  • 6.8.6 (17 Jan 2014)
    • Fixed 'Time Remaining' bug when estimates are factored by % completion
    • Fixed completion time not being assigned to tasks
    • Added a space after inserting Date/Time
    • Preferences Apply button now hidden until it works properly
    • Fixed comments changes not adding '*' to active tab on just-opened tasklists
    • Fixed rich-text formatting bug when indenting lists
    • Fixed crash with circular references
  • 6.8.5 (10 Jan 2014)
    • Fixed preferences initialisation bug
  • 6.8.4 (01 Jan 2014)
    • Set selection to first of commandline tasklists
    • Fixed toolbar visibility bug after changing theme
    • Fixed text comments not getting copied/saved
    • Prevent loss of selection when clicking outside Gantt items
  • 6.8.3 (21 Dec 2013)
    • Fixed bug in previous shortcut manager fix
    • Fixed rich-text paste bug
    • Fixed lost comments after Gantt edit
    • Fixed task pos not updating after move
    • Updated sample tasklist format
    • Fixed project name missing from .tdl export
    • Scroll to selection after un-maximising comments
    • Fixed re-entrant message box with 'Due by Now' filter
    • Added support for 'Last Mod' to tasklist
    • Due date control initialised to later of Start date and 'today'
    • Rationalised comments formats when exporting
    • Updated Russian translation
    • Fixed bug reading default list items from preferences
    • Fixed welcome wizard header translation issue
    • Fixed tasklist metadata not being saved
    • Fixed missing csv custom attribute column header
    • Fix various commandline related issues
    • Fixed readonly status droplist bug
  • 6.8.2 (07 Dec 2013)
    • Fixed 'Goto Today' in Gantt chart
    • Fixed location of DropBox and GoogleDrive user folders
    • Fixed missing XML date tags in task file
  • 6.8.1 (03 Dec 2103)
    • Fixed Preferences dialog to fit available screen work area
    • Fixed Calendar display bug with selected 'special' days
    • Fixed shortcut manager when editing task title
    • Fixed 'First day of week' bug in Calendar view
    • Fixed custom filter bug in Filter dialog
  • 6.8 Feature Release (30 Nov 2013)
    • Add check for missing Outlook 2010 protocol and prompt to install
    • Add 'Shift+Wheel' horizontal scrolling
    • Add support for setting status when completing a task
    • Add support for read-only dynamic lists
    • Add support for pasting text filepaths as links in comments field
    • Add drag'n'drop support to modify Calendar dates
    • Add option to filter by 'recently modified'
    • Add drag'n'drop support to modify Gantt dates
    • Add more snooze time periods
    • Add week numbers to calendars
    • Add Calendar tooltips for long task text
    • Add preference to hide 0%
    • Add preference to control 'recently modified' duration
    • Add PNG image support
    • Add modeless 'per-tasklist' due task notifications
    • Add tree control to Outlook importer
    • Add 'Paste as Reference' to 'Edit' menu
    • Calculate Gantt range dynamically
    • Change Calendar start of week to match Windows settings
    • Display accumulated values for 'float' type custom attributes
    • Expand parent tasks when dragging over from 'outside' TDL
    • Fix date control to not change the date until the calendar closes
    • Implement milestones in Gantt view
    • Implement 'narrow months' as 01/13 etc in Gantt view
    • Improve Welcome Wizard
    • Rewrite Calendar plugin to support continuous date ranges
    • Restore preference to disable column header sorting
    • More than 50 bug fixes
  • 1.1-6.7 (removed by .dan.g.)
  • 1.0 (4 Nov 2003)
    • Initial release.


This article, along with any associated source code and files, is licensed under The Eclipse Public License 1.0


About the Author

Software Developer Maptek
Australia Australia
.dan.g. is a naturalised Australian and has been developing commercial windows software since 1998.
For all his latest freeware visit AbstractSpoon.

Comments and Discussions

Question6.6 B1 small bug in %complete UI Pinmemberjohnrhutchinson17-Jan-13 21:54 
AnswerRe: 6.6 B1 small bug in %complete UI Pinmember.dan.g.18-Jan-13 22:22 
GeneralRe: 6.6 B1 small bug in %complete UI Pinmemberjohnrhutchinson20-Jan-13 7:09 
GeneralRe: 6.6 B1 small bug in %complete UI Pinmember.dan.g.20-Jan-13 13:51 

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
Web01 | 2.8.150326.1 | Last Updated 28 Feb 2015
Article Copyright 2003 by .dan.g.
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid