DarkStep Popup version 2.0 ~~~~~~~~~~~~~~~~~~~~~~~~~~ Table of Contents ----------------- Part 1 - Introduction Part 2 - What's New Part 3 - Installation Part 4 - Usage Part 5 - Problems/Incompatibilities Part 6 - Bug Reports/Suggestions Part 7 - Version History Part 8 - Future Plans Part 9 - Credits/Thanks Part 1 - Introduction What is Popup? It's a port of the core LiteStep Popup module as the LiteStep module format is slowly diverging from the one that DS is based on and I didn't want to have to keep on updating the LiteStep compatibility layer for DarkStep. This is also the first of the new DarkStep GUI configurable modules. All the previous Step.Rc based settings (as well as some new ones) have been transported to a graphical dialog through which you can change the configuration of the Popups. I have also added a default Popup menu so that the Popups will work out of the box with no configuration whatsoever. Part 2 - What's New * Fixed menu definitions getting messed up on the next reload, especially with custom folders * Fixed a Tasks folder always overwriting the item above it * Fixed the command browse button bringing up the directory browser instead of the file browser * Fixed newly created items and folders not getting focus * Fixed items with parameters not being executed properly Part 3 - Installation a) Copy Popup.dll to your DarkStep directory. (If you are currently running a Popup module, first unload it via the DarkStep Module Management dialog) b) Get the DarkStep Configuration dialog (either by right-clicking on the border of the Console or by executing !Config in the Console) and add Popup.dll to the module list. c) If you want the module to work immediately (instead of the next time you run DarkStep), load the module via the Module Management dialog (accessed via !Modules) d) Once you have the module running, type in !popupconfig in the Console to bring up the GUI configuration dialog from where you can define the Popups or change default settings. Part 4 - Usage The Popups can normally be invoked by either right-clicking on the desktop or executing !Popup from a shortcut, hotkeys or the Console. The right-clicking on the desktop may not work if you use a desktop module that allows you to bind mouse-clicks and you have the right-click bound to a different action. In addition to that, the DS Popups support a new !bang command called !Popupat which takes x and y coordinates thus: !Popupat 10,15 While the normal invocation of the Popups would display them where the mouse cursor was on the screen, !Popupat displays the Popups at the position indicated by the coordinates irrespective of the cursor position. Note that you shouldn't have a space after the separating comma. You can configure the Popups at any time by invoking the GUI configuration dialog for the Popups by executing !popupconfig. Part 5 - Problems/Incompatibilities - If you delete all items in your Popup menu, you are in big trouble :-) - You cannot rename the Popup.dll Part 6 - Bug Reports/Suggestions There are several ways to get support or to offer suggestions: - You can stop in #ds_help on any EFNet IRC server and ask one of the ops - You can join the darkstep@egroups.com (http://www.egroups.com/group/darkstep or just send a blank email to darkstep-suscribe@egroups.com) - You can use the DarkStep web board at http://www.coolboard.com/boardshow.cfm/mb=872770840657833 - You can e-mail me at FahimF@email.com Part 7 - Version History 2.0b2 (31 May 2000) * Fixed the Popups crashing when an item is deleted and you try to bring up the menu * Fixed the Popups crashing when an item or folder is added the very first time Popups are loaded (Thanks Ian!) * Fixed not being prompted to save changes if you click "OK" instead of selecting another item * Fixed the Common Start Menu path not being properly set for NT users * Fixed the Popup Style changes not being saved * Fixed the final item being erased by the bottom pic (if there's one) when switching from plain mode 2.0b1 (28 May 2000) - Removed all the Step.Rc configuration reading code + Added new code to read all settings from the registry + Added a GUI configuration dialog which would allow you to change Popup settings + Added a new !popupconfig !bang command which allows you to access the GUI dialog + Added settings for item text color and individual definition of item and title heights 1.0 (10 May 2000) * Brand-spanking port of the LiteStep Popup code * Changed HotListName, NoPopupTransparent, ShrinkPopupBar to PopupName, TransparentPopups, TileImages respectively + Added a new !bang command named !Popupat * Changed the internal !bang handling to make use of the new COM event sink Part 8 - Future Plans I have no immediate plans for the Popups. Part 9 - Credits/Thanks - demigod, Bob Wells, tin_omen, KuhnDog and all the other beta testers who've always been so helpful Fahim (FahimF@email.com) Popup documentation rewritten and formatted by demigod for Fahim Farook. contact: demigod@darkstep.com last updated: 05/31/00 9:57AM