LiteStep v. 0.24.6 documentation

written by the LiteStep Documentation Effort, August 2000
  .: introduction   .: configuration   .: installation   .: theme installation   .: theme creation   .: development   .: glossary   .: links  
  .: command   .: desktop   .: litestep   .: lstime   .: hotkey   .: popup   .: shortcut   .: systray   .: taskbar   .: vwm   .: wharf  
What does desktop2.dll do?
Desktop2.dll uses an invisible window of configurable size for you to click on. By configuring a desktop size, you are setting the size to which your maximized applications will fill. This will not affect the use of any LiteStep module. Desktop2.dll also allows you to assign actions to mouse clicks on the desktop. For example, when you right-click on the desktop, by default, desktop2.dll displays the popup. Consider this module, or one of the Third-Party replacements, to be REQUIRED for LiteStep use.

Note: In order for most LiteStep modules to work correctly they need to be loaded after your desktop module. Therefore, it is normally good practice to put your desktop2.dll LoadModule line before all other LoadModule lines.

Step.RC Syntax for desktop2.dll
DesktopLeftClick [ACTION] Informs desktop2 what to do when you left click on the desktop. Any !Bang Command or Application can be used as an action.

Example: DesktopLeftClick !Popup

DesktopMiddleClick [ACTION] Informs desktop2 what to do when you middle click on the desktop. Any !Bang Command or Application can be used as an action.

Example: DesktopMiddleClick !About

DesktopRightClick [ACTION] This command is executed when you right click on the desktop. The right-click can be customized to whatever you wish, just as with DesktopLeftClick and DesktopMiddleClick.

Example: DesktopRightClick c:\windows\system\desk.cpl

Default: !Popup

DesktopX1Click [ACTION]
DesktopX2Click [ACTION] 		With these settings you may configure your two extra Microsoft Intellimice Buttons on your Intellimouse Explorer to do actions just like the above. However, an important note has come from the Dev Team on this. You CAN NOT load the Microsoft Intellimouse software while using this feature, it messes things up.

Example:    DesktopX1Click "c:\windows\notepad.exe C:\litestep\step.rc"
   DesktopX2Click !Popup2

SetDesktopArea[NUMBER]

SDALeft
SDARight
SDATop
SDABottom

 		This command enables custom desktop sizes, which can be very useful if there is some part of your theme that you don't want to be covered by maximized windows. The [NUMBER] is optional; however, in multimonitor systems it will allow you to configure different resolutions on different monitors.

SetDesktopArea[NUMBER] uses the following commands to set the desktop size with respect to each side of the screen:

Default: 1

   SDALeft [NUMBER]
      Default: 0

   SDARight [NUMBER]
      Default: 0

   SDATop [NUMBER]
      Default: 0

   SDABottom [NUMBER]
      Default: 0

Example: Maximized windows will fill the whole screen except for a 10 pixel border around the screen edge.

SetDesktopArea
   SDALeft    10
   SDARight   0
   SDATop     10
   SDABottom  -10

SetDesktopArea2
   SDALeft    0
   SDARight   -10
   SDATop     10
   SDABottom  -10
SetDesktopAreaMainMonitorOnly [BOOL] Any SDALeft, SDARight, SDATop, SDABottom settings will only be applied to the main monitor. If you are in a multimonitor system the workarea of the remaining monitors will be set to their resepective maximum screen size.
!Bang Commands for desktop2.dll
!DesktopSetLeftClick [ACTION]
!DesktopSetMiddleClick [ACTION]
!DesktopSetRightClick [ACTION]
!SetDesktopX1Click [ACTION]
!SetDesktopX2Click [ACTION] 		This will allow you to change what happens when you click with the specified buttons on the desktop. This makes it possible to change the mouse-click action on the fly.

Note: The !SetDesktopX !bangs will only work if you have a Microsoft Intellimouse Explorer and do not have the Intellimouse software running.

!DesktopSetArea [NUMBER] [NUMBER] [NUMBER] [NUMBER] Allows you to change the size of the Desktop Area on the fly. This can be helpfull when starting an application that needs to be run fullscreen.

Note: Settings are read as Left, Right, Top, Bottom from left to right and all of them must be specified.