Copyright: Copyright ® 1994, Burrell Software Enterprises


Contents

Welcome to Cleo v1.11, the "Convenient Little Environment Organizer" for Microsoft Windows!

I had three main goals in mind when I wrote Cleo:

1. Provide quick, easy, and consistent access to Program Manager items.

2. Provide a simple, keyboard-driven virtual screen system.

3. Provide clear and concise indications of systems attributes such as disk space, free memory and resources, and date and time.

I also required a minimal usage of screen real estate.

The results of these goals are visible in Cleo's clean, uncluttered appearance.  The first two items above are incorporated into Cleo's menu bar, while all status is handled by the aptly-named status bar.  As you will also find out, Cleo is incredibly configurable.

Incidentally, the name "Cleo" comes from my dog, who is an occassionally inconvenient, medium-sized, home environment organism!

Help Topics:

System Requirements

Installation

Configuration

Using Cleo

Planned Improvements

Technical Notes

Release History

Disclaimer

Contacting the Author

Registration

For Help on Help, Press F1.


System Requirements

Cleo requires the following minimal system configuration:

 Microsoft Windows v3.1 in standard or 386 enhanced mode

 PC with 80386 or higher microprocessor

 4 MB or higher system RAM

Cleo has been tested on and is used successfully every day on Windows for Workgroups v3.11.


Installation

Cleo is easy to install!

You should have received Cleo v1.10 in the archive file CLEO11.ZIP.  Copy this file to a subdirectory such as "C:\CLEO" and expand it.  The following files should now reside in that directory:

 CLEO.EXE	 	- main executable

 CLEOTASK.EXE	- Task Manager simulator for Cleo

 CLEOHOOK.DLL	- keyboard and mouse hook library

 CLEOPM.DLL	 - Program Manager DDE interface library

 CLEOVCSR.DLL	- Virtual Screen support library

 MUSCROLL.DLL	- Spin button control library

 CTL3D.DLL	 	- Microsoft's 3D control library

 CLEO.HLP	 	- main help file

 README.TXT	- quick description of files and installation tips

After you run Cleo for the first time and change options, the file CLEO.INI will be created in this directory.  Cleo makes no modifications to any other .INI files.

Cleo plays together well with other programs in the big Windows sandbox.  It does not create files or add entries to *.INI files in any directory other than its own.  If for some strange reason you need to remove it from your system, just remove this directory and all its contents.  You'll have no footprints remaining to prove Cleo was ever there!


Configuration

Cleo is configured with the "Options" dialog.  To access this dialog, click on the "Cleo" menu with the little cyan doggy at the left end of the menu bar.  This is one of those multiple personality dialogs in which the controls change with the current selection of the category list box.  The option categories are summarized below.  Each category also has more detailed help available by clicking on the bitmap picture.

Confirmation: Choose whether you want Cleo to confirm your exit/restart/reboot commands.

Date/Time: Choose how you want the date and time displayed.

DOS: Choose the files used to launch full-screen and windowed DOS sessions.

Drives: Choose how you want disk drive status displayed.

General: Choose options that affect Cleo as a whole.

Launch Apps: Choose programs you want automatically launched when Cleo is launched.

Memory/Resources: Choose how you want memory and resource status displayed.

MenuBar: Choose how you want the menu bar displayed. Also set up the user menu.

Run: Choose how you want the Run dialog box to behave.

StatusBar: Choose how you want the status bar displayed.  Also select active status panes, their order, and the font to use.

Virtual Screens: Choose hotkeys and names for virtual screens, how icons behave, and programs that appear on every screen.


Using Cleo

Cleo is designed to let you perform common tasks quickly and easily.  Here are some of the basic features it offers:

- alphabetized menu access to Program Manager groups.

- keyboard access to virtual screens.

- user-defined popup-menu.

- displayed status of system memory, drive space, resources, date & time.

- single-click access to windowed and full-screen DOS sessions.

- single-click access to a file run dialog.

- single-click access to exiting and restarting Windows.

All these features can be configured to an almost ridiculous degree, so it should be easy for you to make Cleo perform just the way you like it!


Planned Improvements

These are some of the planned improvements; I am open to suggestions for other features you would like to see in Cleo.

- ability to turn off certain features, such as Program Manager interface, virtual screens, etc.

- nested menus for both the Program Manager and user-defined popup menus.

- better international support of date and time formats.


Technical Notes

Language and Libraries :

Cleo was developed in C++ with the Microsoft Foundation Classes, version 2.5.  It uses the CTL3D and MicroScroll libraries from the Microsoft Developer's Network CD.

Desktop Popup Menu:

If you have this menu enabled, Cleo looks for a right- or left-button mouse click on the desktop window.  If are running a program that overlays the desktop window, Cleo will not find what it is looking for and the menu will not popup.  A good example of this type of program behavior is in Dropper.  This program (thankfully) allows you to select one of two methods (subclass or overlay) for intercepting messages to the desktop window.  When using Dropper with Cleo, the subclass method will allow Cleo's desktop popup menu to function, while the overlay method will not.

Subclassing:

Cleo performs no subclassing of any other windows in your system.

Hooks:

Cleo installs three hooks:

- a CBT hook, for determining when windows are created and destroyed.

- a mouse hook, for enabling the desktop popup menu.

- a keyboard hook, for detecting menu bar and virtual screen hotkeys.

Resources:

Cleo goes to great lengths to minimize its resource hit.  Because your Program Manager groups and your user-defined menu could become huge, they can potentially take a big bite out of menu (USER) resources.  Therefore, the actual menus are constructed only if you "ask" for them, i.e. you bring their menus into view.  This means that if you look at these menus, you will momentarily take the resource hit, but those resources are returned to the system as soon as the menu is dismissed.  (For you programmer types out there, this actually occurs when the "menu loop" is exited.)

Disk Caches:

Cleo will detect and flush SmartDrive and compatible disk caches before exiting Windows, restarting Windows, and rebooting your system.  This is added for your personal peace of mind.

Windows NT:

Even though Cleo is a WIN16 application, it is sensitive to running under Windows NT.  This means that all menu and dialog references to exiting Windows, restarting Windows, and rebooting your system become the single item "logoff Windows NT".  Also, Cleo will not attempt some of its "trickier elements" (read: assembly language) to determine drive types and interact with SmartDrive when running under NT.


Release History

Version 1.11

- Fixed bug that allowed more than one Window List dialog to come up.

- Fixed bug that brought up wrong help topics in Options dialog.

- Added CompuServe registration info to help file and README.TXT.

Version 1.10

- First general release to public.

Version 1.10 Betas 1 through 12

- Releases for a small group of friends.

- Bug fixes and enhancements.

Version 1.00

- Private use only.

- Proof and testing of general concepts.


Disclaimer

Cleo is distributed as shareware.  No warranty exists, either expressed or implied.  No liability is assumed for any damage or loss resulting from the use of this program.  No claims are made regarding the accuracy of this program.


Contacting the Author

To contact the author, try either of these addresses:

 CompuServe

 71163,2001

 U.S. MAIL

 Patrick M. Burrell

 Burrell Software Enterprises

 4718 Millhaven Dr. SE

 Kentwood, MI  49548

I gladly welcome all comments, suggestions, gripes and questions concerning Cleo and its operation.  Obviously, if you register the program with me, I will be much more receptive to your communications!


Registration

Cleo is quality shareware!

Because Cleo is shareware, you are given permission to use and evaluate it for a period of 15 days.  If, at the end of this 15 day trial period, you decide that Cleo does not fulfill your needs and desires for a nifty Windows utility, then merely stop using it and that's it.  Better yet, pass it on to someone else who may find it useful.  However, if you decide you simply cannot live without Cleo, you must register it with the author.  For a small fee of $15 (US funds), you will be entitled to free updates for the life of the product, and special discounts on any other shareware produced by the author.  By registering Cleo, you will also get the chance to help shape its future with your comments, suggestions, and bug reports.

The full product and associated files may be freely distributed as long as no fee is charged beyond reasonable costs incurred in disk duplication, etc.

To register Cleo on CompuServe, type "GO SWREG" and follow the instructions.  Cleo's registration ID is 2220.

To register Cleo by U.S. Mail, print out this form and send it with a check or money order (payable to Patrick M. Burrell) in the amount of $15 (US funds).

Date:	 	 	_____/_____/_____

Number of Copies:	__________

Name:	 ________________________________________

Company:	________________________________________

Address:	________________________________________

 	________________________________________

 	________________________________________

Comments:	________________________________________________________________________________

 	________________________________________________________________________________

 	________________________________________________________________________________

 	________________________________________________________________________________

 	________________________________________________________________________________

 	________________________________________________________________________________

 	________________________________________________________________________________

Thank you very much for trying Cleo!

See Also:

Contacting the Author


Confirmation Options

Use this group of controls to set your confirmation options in the Options dialog.  Click on each control for an explanation of that control and its effects.


Confirm Cleo Exit Checkbox

When this checkbox is checked, you will be presented with a confirmation dialog box when you exit Cleo.


Confirm Windows Exit Checkbox

When this checkbox is checked, you will be presented with a confirmation dialog box when you choose to exit Windows through Cleo.

Under Windows NT, this checkbox becomes "Confirm Windows NT Logoff".


Confirm Windows Restart Checkbox

When this checkbox is checked, you will be presented with a confirmation dialog box when you choose to restart Windows through Cleo.

Under Windows NT, this checkbox does not appear.


Confirm System Reboot Checkbox

When this checkbox is checked, you will be presented with a confirmation dialog box when you choose to reboot your computer through Cleo.

Under Windows NT, this checkbox does not appear.


Date/Time Options

Use this group of controls to set your date and time options in the Options dialog.  Click on each control for an explanation of that control and its effects.


Date: Short Form Radio Button

When this radio button is selected, the short form of the date is displayed in the date status bar pane.

Shortcut: Click the date status pane and select the "Short Format" item on the popup menu.


Date: Long Form Radio Button

When this radio button is selected, the long form of the date is displayed in the date status bar pane.

Shortcut: Click the date status pane and select the "Long Format" item on the popup menu.


Date: Double-Click App

This edit field is filled with the file name of the application you wish to launch when the date status bar pane is double-clicked.


Date: Browse Double-Click App

When this button is clicked, a dialog is brought up that allows you to browse for the file name of the date double-click app.


Time: 12 Hour Radio Button

When this radio button is selected, the 12 hour form of the time is displayed in the time status bar pane.

Shortcut: Click the time status pane and select the "12 Hour" item on the popup menu.


Time: 24 Hour Radio Button

When this radio button is selected, the 24 hour form of the time is displayed in the time status bar pane.

Shortcut: Click the time status pane and select the "24 Hour" item on the popup menu.


Time: Double-Click App

This edit field is filled with the file name of the application you wish to launch when the time status bar pane is double-clicked.


Time: Browse Double-Click App

When this button is clicked, a dialog is brought up that allows you to browse for the file name of the time double-click app.


DOS Options

Use this group of controls to set your DOS session options in the Options dialog.  Click on each control for an explanation of that control and its effects.


DOS: Windowed Session

This edit field is filled with the file name you wish to launch to bring up a windowed DOS session.

The windowed DOS session can be launched 2 ways:

- select the "DOS Session" item on the Cleo menu,

- left-click on the "C:" button on the status bar.


DOS: Browse Windowed Session

When this button is clicked, a dialog is brought up that allows you to browse for the file name to launch a windowed DOS session.


DOS: Normal Radio Button

When this radio button is selected, the windowed DOS session will be brought up in its normal state.


DOS: Maximized Radio Button

When this radio button is selected, the windowed DOS session will be brought up maximized.


DOS: Minimized Radio Button

When this radio button is selected, the windowed DOS session will be brought up minimized.


DOS: Full-Screen Session

This edit field is filled with the file name you wish to launch to bring up a full-screen DOS session.

The full-screen DOS session can be launched 3 ways:

- hold down the SHIFT key and select the "DOS Session" item on the Cleo menu,

- hold down the SHIFT key and left-click on the "C:" button on the status bar,

- right-click on the "C:" button on the status bar.


DOS: Browse Full-Screen Session

When this button is clicked, a dialog is brought up that allows you to browse for the file name to launch a full-screen DOS session.


Drive Options

Use this group of controls to set your disk drive options in the Options dialog.  Click on each control for an explanation of that control and its effects.


Drive: Used Space Radio Button

When this radio button is selected, the amount of space used on the selected drive is displayed in the drive status bar pane.

Shortcut: Click the drive status pane and select the "Used" item on the popup menu.


Drive: Free Space Radio Button

When this radio button is selected, the amount of free space remaining on the selected drive is displayed in the drive status bar pane.

Shortcut: Click the drive status pane and select the "Free" item on the popup menu.


Drive: KB Units Radio Button

When this radio button is selected, the drive status bar pane displays the amount in kilobytes (KB).

Shortcut: Click the drive status pane and select the "KB" item on the popup menu.


Drive: MB Units Radio Button

When this radio button is selected, the drive status bar pane displays the amount in megabytes (MB).

Shortcut: Click the drive status pane and select the "MB" item on the popup menu.


Drive: Selector Combo Box

This combo box is used to select the disk drive displayed in the drive status bar pane.

Shortcut: Click the drive status pane and select the desired disk drive on the popup menu.  The type of drive (floppy, hard, RAM, CD and network) is shown in bitmap form to the left of the drive letter.


Drive: Double-Click App

This edit field is filled with the file name of the application you wish to launch when the drive status bar pane is double-clicked.


Drive: Browse Double-Click App

When this button is clicked, a dialog is brought up to allow you to browse for the file name of the drive double-click app.


General Options

Use this group of controls to set your general Cleo options in the Options dialog.  Click on each control for an explanation of that control and its effects.


Hide Program Manager Check Box

When this checkbox is checked, Cleo will hide Program Manager when it starts up.

Note: When Cleo is running, Program Manager can be shown or hidden by selecting the first item under the "Program Manager" menu.


Enable Popup Menu Check Box

When this checkbox is checked, Cleo's main menu is available by clicking the left or right mouse button on the desktop.


Desktop Menu: Left Radio Button

When this radio button is selected, Cleo's main menu is brought up by clicking the left mouse button on the desktop.  The desktop popup menu must be enabled for this to happen.


Desktop Menu: Right Radio Button

When this radio button is selected, Cleo's main menu is brought up by clicking the right mouse button on the desktop.  The desktop popup menu must be enabled for this to happen.


Force Paths: Upper Case Radio Button

When this radio button is selected, Cleo forces all file names and paths to upper case in edit fields.


Force Paths: Lower Case Radio Button

When this radio button is selected, Cleo forces all file names and paths to lower case in edit fields.


Launch App Options

Use this group of controls to set your launch app options in the Options dialog.  Click on each control for an explanation of that control and its effects.


Launch App List Box

This list box contains the applications that Cleo will launch when it starts up.


Add Launch App

When this button is clicked, you are given a dialog to add a new launch app.


Delete Launch App

When this button is clicked, the currently selected launch app is deleted from the list.


Modify Launch App

When this button is clicked, you are given a dialog to modify the currently selected launch app information.

Shortcut: Double-click on the item in the list box you wish to modify.


Memory/Resource Options

Use this group of controls to set your memory and resource options in the Options dialog.  Click on each control for an explanation of that control and its effects.


Memory: Used Radio Button

When this radio button is selected, the amount of memory used is displayed in the memory status bar pane.

Shortcut: Click the memory status pane and select the "Used" item on the popup menu.


Memory: Free Radio Button

When this radio button is selected, the amount of free memory is displayed in the memory status bar pane.

Shortcut: Click the memory status pane and select the "Free" item on the popup menu.


Memory: KB Units Radio Button

When this radio button is selected, the memory status bar pane displays the amount in kilobytes (KB).

Shortcut: Click the memory status pane and select the "KB" item on the popup menu.


Memory: MB Units Radio Button

When this radio button is selected, the memory status bar pane displays the amount in megabytes (MB).

Shortcut: Click the memory status pane and select the "MB" item on the popup menu.


Memory: Double-Click App

This edit field is filled with the file name of the application you wish to launch when the memory status bar pane is double-clicked.


Memory: Browse Double-Click App

When this button is clicked, a dialog is brought up that allows you to browse for the file name of the memory double-click app.


Resources: Used Radio Button

When this radio button is selected, the amount of resources used is displayed in the resource status bar pane.

Shortcut: Click the resource status pane and select the "Used" item on the popup menu.


Resources: Free Radio Button

When this radio button is selected, the amount of free resources is displayed in the resource status bar pane.

Shortcut: Click the resource status pane and select the "Free" item on the popup menu.


Resources: USER Radio Button

When this radio button is selected, the resource status bar pane displays the USER resources.

Shortcut: Click the resource status pane and select the "USER" item on the popup menu.


Resources: GDI Radio Button

When this radio button is selected, the resource status bar pane displays the GDI resources.

Shortcut: Click the resource status pane and select the "GDI" item on the popup menu.


Resources: Total

When this radio button is selected, the resource status bar pane displays the TOTAL resources.

Shortcut: Click the resource status pane and select the "Total" item on the popup menu.


Resources: Double-Click App

This edit field is filled with the file name of the application you wish to launch when the resource status bar pane is double-clicked.


Resources: Browse Double-Click App

When this button is clicked, a dialog is brought up that allows you to browse for the file name of the resource double-click app.


MenuBar Options

Use this group of controls to set your menu bar options in the Options dialog.  Click on each control for an explanation of that control and its effects.


MenuBar: Show Check Box

When this check box is checked, Cleo's menu bar is displayed.


MenuBar: Always On Top Check Box

When this check box is checked, Cleo's menu bar remains on top of all other windows.


MenuBar: Top Radio Button

When this radio button is selected, Cleo's menu bar is displayed at the top of the screen.


MenuBar: Bottom Radio Button

When this radio button is selected, Cleo's menu bar is displayed at the bottom of the screen.


MenuBar: Hotkey

This edit field contains the hotkey combination that will activate Cleo's menubar.  To enter a hotkey, click in this field with the mouse, and type the keystroke combination you want for the hotkey.  A textual representation of that keystroke will appear in the edit field.


MenuBar: No Hotkey

When this button is clicked, the menu bar hotkey is reset to nothing.


MenuBar: Enable User Menu Check Box

When this check box is checked, the user-defined menu is added to Cleo's menu bar.


MenuBar: Configure User Menu

When this button is clicked, a dialog is brought up that allows you to build your own custom user menu to add to Cleo's menu bar.

See Also:

Configuring User Menu


Configuring User Menu

This dialog box is very similar to the Tools editing dialog in Visual C++.  Its controls and operation should be self-explanatory.


Run Options

Use this group of controls to set your run dialog options in the Options dialog.  Click on each control for an explanation of that control and its effects.


Run: Initial Directory

This edit field is filled with the path you wish the Run dialog to initially come up in.


Run: Save Last Directory Check Box

When this check box is checked, the Run dialog will remember the last path you launched an app from.


Run: Normal Radio Button

When this radio button is selected, the Run dialog will initially have the Show Normal radio button selected.


Run: Maximized Radio Button

When this radio button is selected, the Run dialog will initially have the Show Maximized radio button selected.


Run: Minimized Radio Button

When this radio button is selected, the Run dialog will initially have the Show Minimized radio button selected.


Run: Save Last Show Command Check Box

When this check box is checked, the Run dialog will remember the last show command you launched an app with.


Status Bar Options

Use this group of controls to set your status bar options in the Options dialog.  Click on each control for an explanation of that control and its effects.


StatusBar: Show Check Box

When this check box is checked, Cleo's status bar is displayed.


StatusBar: Always On Top Check Box

When this check box is checked, Cleo's status bar remains on top of all other windows.


StatusBar: Top Radio Button

When this radio button is selected, Cleo's status bar is displayed at the top of the screen.


StatusBar: Bottom Radio Button

When this radio button is selected, Cleo's status bar is displayed at the bottom of the screen.


StatusBar: Update Seconds

This edit field is filled with the number of seconds between automatic updates to Cleo's status bar panes.


StatusBar: Available Panes List Box

This list box contains the status bar panes that are available for including on the status bar.


StatusBar: Remove Pane

When this button is clicked, the currently selected status bar pane in the "selected" list box is removed and placed in the "available" list box.

Shortcut: Hold down the CTRL key while left-clicking on the status bar to drag and drop individual panes on the desktop.  The cursor will change to an open trashcan to indicate a successful removal.


StatusBar: Include Pane

When this button is clicked, the currently selected status bar pane in the "available" list box is removed and placed in the "selected" list box.


StatusBar: Selected Panes List Box

This list box contains the selected status bar panes that will show on the status bar.


StatusBar: Move Pane Up

When this button is clicked, the current status bar pane in the "selected" list box is moved up one position.  This results in the selected pane moving to the left on the screen.

Shortcut: Hold down the CTRL key while left-clicking on the status bar to drag and drop individual panes in different positions.  The cursor will change to the name of the pane you are moving.


StatusBar: Move Pane Down

When this button is clicked, the currently selected status bar pane in the "selected" list box is moved down one position.  This results in the selected pane moving to the right on the screen.

Shortcut: Hold down the CTRL key while left-clicking on the status bar to drag and drop individual panes in different positions.  The cursor will change to the name of the pane you are moving.


StatusBar: Font Preview

The area gives a preview of the current status bar font.


StatusBar: Change Font

When this button is clicked, the Windows common dialog Font Selector is brought up so you can specify the status bar font.


Virtual Screen Options

Use this group of controls to set your virtual screen options in the Options dialog.  Click on each control for an explanation of that control and its effects.

Omnipresent Apps are applications whose windows will appear on every virtual screen.


VScreens: Omnipresent Apps List Box

This list box contains the current omnipresent apps.  Omnipresent apps appear on every virtual screen.


VScreens: Add Omnipresent

When this button is clicked, a dialog is brought up that allows you to add an omnipresent app.


VScreens: Delete Omnipresent App

When this button is clicked, the currently selected omnipresent app is deleted.


VScreens: Modify Omnipresent App

When this button is clicked, a dialog is brought up that allows you to modify the currently selected omnipresent app.

Shortcut: Double-click on the the omnipresent app you wish to modify.


VScreen: Icons Are Omnipresent Check Box

When this check box is checked, all minimized window icons are treated as omnipresent; that is, they appear on every virtual screen.


VScreen: Selector

This edit field contains the number of the vscreen for which the hotkey and name are currently defined.


VScreen: Hotkey

This edit field contains the hotkey combination that will switch to the currently specified vscreen.  To enter a hotkey, click in this field with the mouse, and type the keystroke combination you want for the hotkey.  A textual representation of that keystroke will appear in the edit field.


VScreen: No Hotkey

When this button is clicked, the currently specified vscreen's hotkey is reset to nothing.


VScreen: Name

This edit field contains the text name of the currently selected vscreen.