****************************************************************************
****************************************************************************
**                          WidgetDock by SioSae                          **
****************************************************************************
****************************************************************************
**									  **
**  This widget was made to get a nice way done, manage widgets in 	  **
**  Konfabulator the way the Dashboard Dock does it for apple users.	  **
**  Also I want to be able to spawn widgets without have to copy&paste    **
**  them manually every time. By the time this widget got more and more   **
**  features but after all it is simply a widget managing dock.		  **
**									  **
**  Not to forget the ability to add Programs and Folder to the Dock too. **
**									  **
**  The use of this Widget is allowed only for non commercial meaning.	  **
**									  **
**  Copyright (C) 2005 Silvio Sachse (siosae@gmx.de)			  **
**									  **
**  - except graphics taken from screenshots of Apples Dashboard and	  **
**									  **
**  - The Default Folder Icon was taken with permission from Everaldo's	  **
**    Crystal Clear Icon Package: 					  **
**     - www.everaldo.com						  **
**     - www.yellowicon.com						  **
**									  **
****************************************************************************
****************************************************************************


****************************************************************************
*              Installation Notes and Important Informations:              *
****************************************************************************

****************************************************************************
* 									   *
* - Please extract the widget file and the WidgetDock folder 		   *
*   included in this zip archive to any location(s) you want.		   *
*									   *
* - At first startup of the WidgetDock you will be asked to specify 	   *
*   the widgets configuration file. Without doing it, the widget 	   *
*   wont start. 							   *
*   Please choose the file "WidgetDock.config" from the extracted	   *
*   WidgetDock folder.							   *
* 									   *
* - The default file "WidgetDock.config" is empty.			   *
*   IMPORTANT: YOU CAN USE YOUR CONFIG FILE FROM OLDER VERSIONS, 	   *
*   JUST COPY IT INTO THE WIDGETDOCK DIRECTORY AND LOAD IT AT STARTUP.	   *
* 									   *
* - The "WidgetDock/icons" folder contains some icons, please read the	   *
*   icons_readme.txt for more information about the images.		   *
* 									   *
* - The "Temp" folder is necessary for widget spawning (DONT DELETE IT).   *
*                                                                          *
* - SET THE WIDGET TO KONSPOSE OR TOPMOST MODE VIA THE PREFERENCES DIALOG. *
* 									   *
****************************************************************************


****************************************************************************
*                             Main Features:                               *
****************************************************************************

****************************************************************************
* 									   *
* - open/close the WidgetDock: - click on the cross                        *
*                              - use the hotkey "CONTROL+F8"               *
* 							                   *
* - loop through bars if there are more items in the Dock (and enabled)    *
*   than can be shown on screen at once                                    *
* 							                   *
* - change the position of the cross by simply drag and drop it.           *
*   It cant be moved over the Dock itself.                                 *
*   The "manage widgets" control will be shown on the left side if you     *
*   move the cross to far right.                                           *
*   Reset the cross position in the context menu.                          *
* 							                   *
* - change screen position of the dock between top and bottom in the       *
*   context menu (top mode maybe only works correct on windows)            *
* 							                   *
* - drag and drop items to the dock.                                       *
*   Works for widgets, directories and applications                        *
*   They will be added the position they dropped into the dock             *
* 							                   *
* - click on "manage widgets" to get the widget manager icon.              *
*   A click on that icon brings up the Widget Manager.			   *
* 									   *
****************************************************************************


****************************************************************************
*                        Widget Manager Features:                          *
****************************************************************************

****************************************************************************
* 							                   *
* - With the Widget Manager you customize the items in your Dock:	   *
* 									   *
*   - flip the add button to add widgets (default), programs or folder     *
* 									   *
*   - enable/spawn/disable any widget you want by clicking on the checkbox *
* 									   *
*     - you can spawn EVERY widget, except ".kon" file widgets   	   *
* 									   *
*     - programs and folders only have two states (disabled and spawned)   *
* 									   *
*   - set a custom image for widgets by clicking on the icon in the list   *
* 									   *
*   - change display name by clicking on the items name in the list        *
* 									   *
*   - flip the sort button to get different sort pattern       		   *
* 									   *
*     - "sort by name" sorts all items by name              		   *
* 									   *
*     - "sort by type" sorts all items by the following order: 1. widget   *
*                                                              2. programs *
*                                                              3. folders  *
* 									   *
*   - resize the Manager by drag and drop the resize control in the lower  *
*     right corner. resize is only done vertically and there will be still *
*     a minimum view of at least six items                                 *
* 									   *
*   - manually sort the items by drag and drop them. it only works in the  *
*     visible range of the manager.                                        *
* 									   *
*   - undo function via the context menu (save all changes made)	   *
* 									   *
*   - additional commandline parameters can be set for programs via the	   *
*     context menu (only available for programs)                           *
* 									   *
****************************************************************************


****************************************************************************
*                          Context Menu Options:                           *
****************************************************************************

****************************************************************************
* 									   *
* - Change Language will set a display Language for context menu entries,  *
*   tooltips and dialog text						   *
* 									   *
* - Set Configuraiton File will allow you to specify another file	   *
* 									   *
* - Set Default Images will allow you to set new default image files for   *
*   widgets, folder and programs added to the dock. This will only effect  *
*   new entries								   *
* 									   *
* - Add all Widgets from Folder will allow you to specify any directory    *
*   where all widgets inside this directory will be added to the dock if   *
*   they arn't already added						   *
* 									   *
* - Close Dock after open a Widget					   *
* 									   *
* - Enable Closing of open Widgets (beta) will close a open widget if you  *
*   click it again in the dock. On some Systems it will result in a crash  *
*   of konfabulator. use at your own risk.                                 *
* 									   *
* - Entering Konspose mode will open the Dock				   *
* 									   *
* - Exiting Konspose mode will close the Dock				   *
* 									   *
* - Set Default Cross Position will reset the cross to the dock on the 	   *
*   side of the screen and forces the cross to move with the dock          *
* 									   *
* - Hide "Manage Widgets..." Button will disable the button. Entering the  *
*   Widget Manager wont be possible by doing so				   *
* 									   *
* - Change Position on Screen to [Top|Bottom]				   *
* 									   *
* - Vertical Offset Mode will enable a little arrow control on the top     *
*   border of the dock in the middle of the screen. drag this control to   *
*   move the dock up and down and specify a certain offset. this only      *
*   in bottom screen mode.                                                 *
* 									   *
* - Resize Mode will enable a little arrow control on the top border of    *
*   the dock in the middle of the screen. drag this control to resize the  *
*   dock until it fits your needs (scale from 30 to 100%)		   *
* 									   *
*   The Vertical Offset Mode and Resize Mode will replace each other       *
* 									   *
*   - for Cross and "Manage Widgets..." too means, this controls will be   *
*     resized with the Dock                                                *
* 									   *
* - Clear WidgetDock will: - empty the config file, 			   *
*                          - reset the dock to initial state, 		   *
*                           (so be sure what you doing by clicking this!)  *
* 									   *
* - Reload WidgetDock							   *
* 									   *
* - Enable/Disable automatic Check for updates. check this, if you dont    *
*   want to be informed about new releases of the WidgetDock on startup.   *
* 									   *
****************************************************************************


Have fun,
SioSae