List Manager v1.1C (2007.08.21)
Copyright (c) 2007 Zachary Panas
Powered by ZETA (tm)
I) Overview
List Manager is used to maintain a list of items. Each item may be open in one of four colors, closed, or a sub list. Each item has a time stamp from when it was created. The text for each item may be up to 32 characters. Any item can also have a sub list of items. Up to 65535 total items may be in the list file.
Listman was written in a few days using the ZETA (tm) programming language to expand my knowledge of tree view controls. It turned out to be a useful tool as well.
II) Installation
List Manager consists of one file: listman.exe. This file should be placed in a new folder. List Manager creates two additional files in this folder (see Files below). Also, a shortcut can be made and placed in the taskbar to enable easy access to listman:
- Right click on listman.exe and select 'Create Shortcut'
- Edit the shortcut text to read "List Manager"
- Drag the shortcut to the taskbar
Version 1.1C may be copied over v1.0A, v1.1A, or v1.1B
Version 1.1B may be copied over v1.0A or v1.1A
Version 1.1A may be copied over v1.0A
III) Window Interface
The window is divided into two parts - the tree view and the status area. The tree view shows the items with icons to show the status. Clicking twice on an item in the tree view will edit the text. The tree view also places a small button next to the icon if the item has a sub list. This button is used expand or collapse the sub list. The status area shows the status for the currently selected item along with the time stamp for that item. Right clicking in the status area brings up the about/hints dialog. The time stamp is formatted as YYYY.MM.DD.HH.mm where YYYY is the year, MM is the month, DD is the day, HH is the hour (24 hour time), and mm is the minute. The status for the root has the number of open items in the list file instead of a time stamp.
The window location is saved when listman closes and restored when it opens.
IV) Keyboard Interface
A new item is created by selecting the parent where the item will be added and pressing the Insert key. The item is inserted at the end of the sub list. The item cannot be moved in the list. If the parent item did not previously have a sub list, the parent item status will be changed to sub list. This can be changed as noted below.
The Delete key will change an open item to a closed item or delete the item. An item with a sub list cannot be deleted. Click 'Ok' in the confirmation message box to delete the item.
The status for the current item may be changed by pressing F1 - F6 as follows:
F1 - Green open item (default for new items)
F2 - Yellow open item
F3 - Red open item
F4 - Blue open item
F5 - Closed item
F6 - Sub list
The status is just the icon and status text. For example, a sub list can be changed to an open item without losing the actual sub list contents.
The tree view has it's own keyboard interface. The up and down arrow keys move the selection. The left and right arrow keys expand or collape a sub list. Typing text does a search that selects the item that matches the text.
When editing item text, additional keys are active. The Enter key saves the text and stops editing. The Escape key cancels the edit and reverts to the previous text.
V) Files
List Manager saves the list in the 'list.l32' file. A changed list is saved every minute, when listman is closed, or another program is clicked on. The list is read when listman is opened.
The 'listman.cfg' file is the window location information. This file is saved when listman closes and read when listman opens.
VI) Bugs and Limitations
The following bugs are currently known:
- Minor: Rarely when a new item is inserted the item is not added to the tree view.
Workaround: The branch of the tree view needs to be collapsed and then expanded to show the item.
The following limitations are noted:
- Items may not be moved once created.
- No undo for create / delete item.
- Time stamps cannot be changed.
- The tree view expansion state is not saved for collaped items
- No printing support
VII) Revision history
2007.06.08 - (1.0A) Initial release.
2007.06.13 - (1.1A) Added about/hints dialog.
2007.06.21 - (1.1B) Fixed first item in root delete error.
2007.08.21 - (1.1C) Changed root status to display the number of open items instead of total items.
VIII) Legal
List Manager is released as freeware. It may be freely distributed provided this documentation is included.
ZETA (tm) is a trademark of ZP Enterprises
*End of Line*