User Tools

Site Tools


This is an old revision of the document!

Task Attribute Preferences

Only show menu commands for visible columns/edit fields

Use this to trim unwanted menu commands off the menu.

Reposition editing controls during resizing

This option will wrap controls as the width of the application changes during resizing.

Position edit fields

The Edit Area, where fields can be modified, can be placed Below the tasklist, or to the Right or Left of the tasklist.

'Stack' edit fields and comments when they occupy the same position (left, right, or below)

The most obvious effect of this can be seen when Comments and fields are both placed on the same side relative to the grid. As an example of how this affects the display:

  • When both are at the bottom, and this field is unchecked, edit fields will appear above comments.
  • When both are at the bottom, and this field is checked, comments display on the bottom left and edit fields display on the bottom right.

Move the input focus to the tasklist when the Enter key is pressed

Wherever the focus is, this option will move the focus back to the tasklist when the Enter key is pressed.

Note: If the focus is on the comments then pressing return will not shift the focus, simply because return is more often used for paragraph marking.

Show tasklist close button on the menubar

This places an X button at the far right of the menubar for closing tasklists. Note: you can also click the middle mouse button on tasklist tabs to close the tasklist.

Use the following theme

ToDoList comes with some simple themes. Use one of the predefined themes or write one of your own using one of the predefined themes as a template.


Filtering is one of ToDoList's most powerful features, allowing you to omit all but a subset of tasks that interest you. This allows you to focus on only the most important tasks.

Allow multi selection in the filter droplists

This turns on the checkbox selection mode in the filter droplists allowing you to select more than one item to filter on.

Restore tasklist filters when restarting ToDoList

This allows you to control whether ToDoList saves and restores the current filters on a tasklist when you close and then re-open it.

Automatically refilter after editing

This can be handy if for instance you are filtering on incomplete tasks and then you complete one of those incomplete tasks. With this option turned on that newly completed tasks is instantly filtered out.

Note: sometimes this feature can work against you especially when using some of the due date filters. This is because as soon as you drop down the due date field the date gets set and this can cause a refilter and remove the task you are editing. At this date there is not solution for this problem.

When filtering by 'Title, match on…

  • Titles only : Do not use comments, even if the first comment line displays with the title.
  • Titles and comments : Include all comments, not just the first line.
  • Any text field (eg. Allocated To, External ID, etc) : When this is used, the concept of “filter by Title” is extended to include all other text fields.


ToDoList allows you to sort tasks against most of the attribute fields.

Always sort completed tasks below other tasks

This is handy if you want to collate all the completed tasks at the bottom of the parent task whilst sorting the rest by whatever field you have selected.

Note: this option does not affect 'unsorted'.


The toolbar stores the most often used commands.

'New Task' button places task…

Because there are more than one 'New Task' menu commands this option allows you to control which one the toolbar button refers to.

'New Subtask' button places subtask…

Because there are more than one 'New Subtask' menu commands this option allows you to control which one the toolbar button refers to.

Task Comments

Preferred format

Select which comments format you want to use by default when tasks are created.


Select whether you want the comments field to appear below the tasklist or to the right of the tasklist.

Show always

If you always want the comments field to show even when you've selected 'View | Maximize Tasklists' choose this option.

Update all tasklists when the comments field is resized

Checking this option ensures that the comments field remains the same height or width regardless of which tasklist you change it on.

Tasklist Tab Bar

Hide tab bar when only one tasklist is open

If you prefer a more consistent user interface then deselecting this option will ensure that the tab bar is always visible even when you only have a single task list open.

Stack tab bar items

Choosing this option if you want to be able to see every tab at all times. Without this option Windows provided scrollbuttons to enable you to scroll tabs into view.

Keep tabs ordered by name

As you load tasklists this option will keep their tabs ordered alphabetically.

Default Task View Visibility

[Views] in the UI can be toggled on/off from here. The views currently available are:

Column/Attribute Visibility

Check the boxes of those attribute values that you want displayed as columns in the task list (useful if certain attributes are not relevant to your needs).

Work in Progress. Add info about visibility and bottom radio options

Tasklist Attributes

Date/Time Formatting

Hide 'Start' and 'Due' dates for completed tasks

This is just one of a number of options for reducing clutter and visiually separating complete and incomplete tasks.

Hide 'Due Time', 'Start Time', 'Completed Time' fields

By default ToDoList allows you to specify the time as well as the date for due, start and completed dates. However since not all people require these fields you can optionally hide them.

Hide zero 'Times' and 'Costs'

Again this helps redues visual clutter my not rendering the time or cost when it is zero.

Display dates in ISO format

The ISO date format is non-locale specific format which ensures that no matter where you are, dates will always look identical. Note: ToDoList always stores dates in ISO format when saving them to disk or when exporting.

Include the weekday when displaying dates

This option displays the abbreviated weekday to the last of the date.

Note: Without this option set dates are aligned to the left of the column, with it they are aligned to the right, just to make scanning the dates easier.

Round 'Time Estimate/Spent' to whole numbers

This simplifies the display of task times without changing the actual values recorded. Again juts to make scanning the tasklist easier.

Display 'Time Estimate/Spent' times in HMS format

This displays times in (what's referred to in TDL as) HMS format. This is not specifically Hours, Minutes, and Seconds. For example, 1.5 hours becomes 1h30m, and 2.75 days becomes 2d6h. If a task is estimated at 50 hours, where 1 day = 8 hours and one week = 5 days, then the value displayed is 1w1d. Large hour values display like 2y5m - that's 2 years and 5 months with days truncated.

Note: the length of a week and the length of a day are those specified elsewhere in the Preferences.

Work in Progress. Missing options


Show Infotips

Displays detailed information when you move the mouse cursor over a task in the task list.

Limit length of comments shown to 'n' characters

Without this option ToDoList would display the entirety of a task's comments in the infotip which would lead to very large and unwieldy infotips.

Display comments after task title in list

This option renders any additional comments after a task's title text in the task list.

Note: the task list scrollbars will not extend to accomodate this extra text so not all of the comment may be visible.

Display only the first line of comments

This is a useful device that you can use to selectively show and hide the comments that are displayed after the task title. To hide the comments simply make the fist line of the comments blank.

Strike-through completed tasks

This useful for picking out which tasks are completed.

Note If you use a high resolution display you might find that the default struck-through font used for completed tasks is virtually unreadable, in which case simple deselect this option.

Display completion checkbox next to task's title

This option moves the checkbox for marking a task as complete tight up against the task's title text rather than in its own column.

Display Subtask completion in front of task's title

This displays fractionally (number of completed subtasks/total number of subtasks) how many of the task's subtasks are completed.

Show Parent tasks with a folder icon

This helps to pick out parent tasks by assciating a folder icon with them.

Note: If you manually specify an icon manually specify an icon then this will override the parent folder icon.

Hide '% Complete' for completed tasks

To help highlight incomplete tasks and to maintain a less cluttered task list you can have ToDoList not display '100%' for completed tasks.

Show '% Complete' as a progress bar

As well as showing a task's completion status as a percentage, you can also display it as a coloured bar (based on its priority).

Hide 'Start' and 'Due' dates for completed tasks.

'Start' and 'Due' dates may have limited relevance once a task has been completed. Select this option to have ToDoList hide such dates when a task has been marked as completed.

Show columns on the right of the task tree

This displays the task title at the left most column and the rest of the columns to the right.

Note: Because of how ToDoList is written internally, any vertical scroll bar will appear between the task title and the rest of the column. There is no workaround for this at this date.

Show non-file links as text

By default ToDoList displays file links by their representative icon. This option allows you to use this field to also store raw text and not have ToDoList try to convert it to a file icon.

Enable full row selection

This option gives the task list a more 'list-like' appearance but at the expense of losing the dotted link lines between tasks and their subtasks.

Display the selected task's path in the list header

In task lists with many tasks, each of which has many subtasks, it is very easy to lose track of just where you are. This option will display the path of the currently selected task in the task list header.

Limit width of columns to 'x' pixels

At this date ToDoList does not allow column widths to be resized, instead it always sizes columns to fit the widest entry. As a result column can become 'too' wide resulting in a difficulty seeing all columns sufficiently. This is a stop-gap solution which will prevent columns exceeding the specified width.

Fonts and Colours

Task list font

At the end of a long day you might like to increase the font size of your task list to suit your tired eyes.

Use same font for comments field also

Select this option to display the comments field in the same font as that selected for the task list.

Comments font

Likewise for the comments field.

Colour 'Priority' column

By default, the priority column is a grayscale box ranging between very light gray (lowest priority) to black (highest priority). If you would prefer colours then you can specify them here.


If you find adjacent gradient shades too difficult to tell apart then you can alternatively specify each priority level as a distinct colour.


Simply specify the 'low' and 'high' colours and let ToDoList do the rest.

Use HSL to calculated intermediate colours

Without going into a deep explanation of HSL, basically it allows perceptual color relationships to be described more accurately than RGB. From my perspective it also prevents the production of 'grays' when blending between two colours.

Hide 'Priority' number

If you find the addition of the priority number to its colour too distracting then you can turn it off.

Show Gridlines

Gridlines can be helpful when scanning across many columns.

Gridline colour

If you use light gray as your normal window backgound colour then you might find the default gridline colour indistinguishable from the background. Change it here if you need to.

Alternate line colour

Specify a background colour for alternate lines to assit in scanning across many columns.

Task Colouring

These options allow you to colour the task text (or background) in a number of different ways.

Colour task titles by Category

This option allows you to manually enter category names together with an associated colour.

Note: As of this date there is no way to import categories entered elsewhere in the preferences.

Colour task titles by Priority

This option allows you to additionally color a task's title by its corresponding priority colour. This allows you to hide the priority column and also give a task's priority better visibility.

Colour task titles by assigned colours

Use this option to colour tasks by the colours you have manually assigned.

Use a task's colour for its title background

By default, the colour you allocate to a task (whether directly or via its priority) is used to render its title text. Selecting this option will use these colors for the tasks' background colour which will give the colours greater emphasis.

Due task colour

Specify a colour to use for all due and overdue tasks.

Note: this colour will override the task colouring specified above

'Due Today' task colour

Specify a colour to distinguish between tasks that are due 'today' and tasks that are overdue (due yesterday and before)

Completed task colour

Specify a colour to use for completed tasks.

Flagged task colour

Specify a colour to use for tasks with the flag attribute set.

Note: This colour overrides the basic task colouring note above but does not override the 'Due', 'Due Today' or 'Completed' task colours.

user-interface-task-prefs.1472730267.txt.gz · Last modified: 2016/09/01 11:44 by admin