proposedmodifications.txt

个人日程管理系统

This is how the Table code will work:

In order to encapsulate things, and reduce code size, the table *module* will *export* the following routines:

Err TableInitialize(TablePtr *table);
Err TableDeInitialize(TablePtr *table);

Err TableScrollToTop(TablePtr *table);
Err TableScrollToBottom(TablePtr *table);
Err TableScrollRelative(TablePtr *table, Int16 scrollAmount); // Negative values scroll up, positive values scroll down

Err TableReSynchronize(TablePtr *table); // Resync table from changes

Int32 TableSelectPoint(TablePtr *table, EventPtr e); // Select the row where the pen down happened, may not be neccesary after OS 4.0, returns selected task index # or -1 if none
Int32 TableGetSelected(TablePtr *table); // Get the currently selected task (if any)


The table code will call the following functions:

Int32 TaskGetNextViewableTask(DmOpenRef DBp); // get the next viewable task index # or -1 if none
Int32 TaskGetPrevViewableTask(HmOpenRef DBp); // get the previous viewable task index # or -1 if none

The table code will use the following globals:

The table code will be in table.c



This how the task view code will work:

Exported Routines:

Int32 TaskGetNextViewableTask(DmOpenRef DBp); // get the next viewable task index # or -1 if none
Int32 TaskGetPrevViewableTask(HmOpenRef DBp); // get the previous viewable task index # or -1 if none
Err TaskViewResetToTop(HmOpenRef DBp); // reset the pointers to the first viewable task
Err TaskViewResetToBottom(HmOpenRef DBp); // reset the pointers to the last viewable task

Err TaskViewMakeTaskRootOfView(HmOpenRef DBp, Int32 TaskID); // Make given task the root of the task view
Err TaskViewMoveViewUpOneLevel(HmOpenRef DBp); // make the current root tasks' parent the root task
Err TaskViewResetViewLevel(HmOpenRef DBp); // make the current root tasks' parent the root task

Err TaskViewSetFlatMode(Boolean flatModeOn); // Set or reset flatmode

Err TaskViewDeleteTree(HmOpenRef DBp, Int32 taskID); // delete the task and subtree rooted at taskID

Non Exported Routines:

Err TaskViewSelectTask(HmOpenRef DBp, Int32 taskID); // select the given task, use highlight
The task view code will be in taskview.c

This is how the task code will work:

Exported Routines:

Err TaskCalcCompleted(HmOpenRef DBp, Int32 taskID); // calculate completed for tree rooted at taskID
Err TaskExpandTree(HmOpenRef DBp, Int32 taskID); // expand task tree rooted at taskID
Err TaskCollapseTree(HmOpenRef DBp, Int32 taskID); // expand task tree rooted at taskID

Int32 TaskGetParentID(HmOpenRef DBp, Int32 taskID); // Get the parent ID of a given task


TaskQueryDeleteTaskTree(HmOpenRef DBp, Int32 taskID); // ask user if they really want to delete tree
TaskDeleteTree(HmOpenRef DBp, Int32 taskID); // delete task tree rooted at taskID

TaskUpInTree(HmOpenRef DBp, Int32 taskID); // Move task up in the tree
TaskDownInTree(HmOpenRef DBp, Int32 taskID); // Move task down in the tree
TaskLeftInTree(HmOpenRef DBp, Int32 taskID); // Move task left in the tree
TaskRightInTree(HmOpenRef DBp, Int32 taskID); // Move task right in the tree


The task code will be in task.c

The task clipboard code will work as follows:

Exported Routines:

TaskToClipboard(HmOpenRef DBp, Int32 taskID, Boolean withParent); // move task tree rooted at taskID to clipboard, and optionally include parent
TaskFromClipboard(HmOpenRef DBp, Int32 taskID, Boolean asChild); // insert task from clipboard as child or sibling