Pimlical Android Help
Tasks View
The Tasks View uses
an event selection list to display Tasks (and/or Floating Events) in a
dedicated list that is not constrained to being in a chronological
order. It also uses the Due Dates for organizing by date (as opposed to
the display date which is used in a view) and has convenient buttons
for quickly changing the priority or urgency of an event. Some of this
can be accomplished of course by using a filter that displays tasks
with the Find function, but the dedicated Tasks View provides a more
convenient way of managing tasks.
Invoking the Tasks View
To invoke the Tasks View, use menu | Tasks View.
You can also put this menu item on the Command Bar as a button (to do
that, go into menu | Preferences | Commands/Functions and pick one of
the preference items for the Command Bar - such as CommandBarViewButton1). The Tasks View will display a Thumbtack icon( 
) on the command bar.
The tasks that are displayed in the Tasks View are controlled by a Pimlical Filter. The default filter is Tasks_Only and this is set in the preference: DefaultTasksViewFilter. After the view appears, there is a Filter
button that you can tap to select a different filter. You should only
select filters that display Tasks and/or Floating events. In addition
to the Filter button are buttons to create a new Task or to bring up
the Template Selection List (which will only show tasks (and floats if
the current template is set to display floats) in the template list).
The Tasks View appears as an Event Selection List with the addition of two large buttons for the Priority and Urgency.
You will typically want to set the preference SelectionlistIconStatusSize to a larger value than SelectionListIconSize
so that the checkbox for the task (or circle for a float) is easily
selectable to mark an item as completed (or incomplete). If you only
want to change the size of this icon for the Tasks View, you can always
attach a custom preference file to the Tasks_only Filter and change it
just in that preference file.
Items displayed in the Selection List of Tasks/Floats
At top right is the Hide/Show
button which can be used to alternately hide or show items that are
currently being hidden by the filter. The button with the Green
CheckMark exits the Tasks View.
On the line below is a button to
create a new task (and a long-press on that button will create a
floating event), a button to bring up the quick entry templates (only
those templates that create tasks or floating events (if the filter
displays floating events) are displayed in that list. Finally, there is
a Filter button that allows
you to select different filters for this view. The filter list only
displays those filters that include tasks and/or floating events. To
set a filter as the permanent default for the Tasks View, set the
preference: DefaultTasksViewFilter to the filter you want to use.
In
the left margin of every row is a tall, thin, vertical bar that shows
the default color of the category that the item is assigned to (default
colors for categories are set in menu | Select Categories).
At
top left, If the Task/Float has a due date, the days past-due or days
till the due date are displayed in a colored box - red if the
item is past-due and green if it is due in the future. Items due today
show Today with a dark gray background.
Next on the top line is
the due date if the task or float has a due date, followed by any
user-assigned icons, and any system icons. If there is no due date for
the item, then (No Due Date)
is displayed for the item. Any system icon can be tapped for additional
information about the event. If the Task is timed, the starting time
for the task is displayed immediately below the due-date box.
On
the next row is the Status icon for the Task (Checkbox) or Float
(Circle) which can be long-pressed to toggle the status setting between Completed and Normal status. This
is followed by the Priority and Urgency
buttons for the event. By default, the buttons are only shown if the
Priority or Urgency has been set for the item, but you can force those
buttons to always display by setting the preference: HidePriorityUrgencyButtonsIfNotSet to false. The order of the two buttons is governed by the preference: ShowUrgencyFirst
which can be set to true or false). Following the buttons is the
description of the Task or Float. This can optionally include the
location and note associated with the item (depending on preference
settings), and the number of lines displayed is controlled by the
preference: MaxLinesInTasksView. In addition to the description, the category, location and note will also be appended depending upon the preference settings (IncludeCategory, IncludeLocation, and includeNote).
Sorting Tasks
Tasks are sorted based upon the settings in the filter. To change the sort, tap on the Filter button and select the filter you want to change. Go into the Sort tab ( 
) and change the sort criteria. Note that you can sort on any one of a dozen criteria (due date, icon, category, status etc.) and
on a dozen levels. In other words, if you pick due date as the first
sort criteria and two items have the same due date, Pimlical then
compares the two items based upon the second sort criteria, and if
those match, it proceeds to the third sort criteria, all the way down
to the very last sort criteria (and if that matches, the items are then
sorted by uniqueID in order to ensure a stable sort that always
displays the items in the same order).