add_shortcut - winbuilder

WinBuilder

Add_Shortcut

Create shortcuts on the desktop, quicklaunch bar or start menu.

Syntax

Add_Shortcut,[Type],[StartMenuFolder],[FullFileName],[Title],[Work Folder],
     [Parameters],[IconFile],[StartMode],[ToolTipText]

Parameters ( * not supported by Vista / Win7 )

1 Type Define the type of shortcut
Desktop - Place an icon on the desktop
StartMenu - Place an icon in the StartMenu\Programs (default value)
QuickLaunch - Add an icon to the Quick Launch bar
SendTo*- Add an icon on the right-click menu "Send To"
AutoStart or AutoRun - Place an icon in the StartMenu\Programs\AutoStart
EditWith - Add an icon on the right-click menu "Edit With %ProgramExe%"
Accessories* - Place an icon in the StartMenu\Programs\Accessories
AdministrativeTools* - Place an icon in the StartMenu\Programs\Administrative Tools
SystemTools* - Place an icon in the StartMenu\Programs\Accessories\System Tools
StartMenuRoot - Place an icon in the StartMenu Root
2 StartMenuFolder Fill this value if you want to force the shortcut to be placed on a specific folder (let it empty for use the script foldername)
3 FullFileName This switch is used if you want to create a shortcut different of %ProgramExe% (No need to give path if File is in same folder as %ProgramExe%)
(default value = %Pe_Programs%\%ProgramFolder%\%ProgramExe%)
4 Title Set your own title for this shortcut (default value = %ProgramTitle%)
5 Work Folder* Decide in which folder should start the program (default value = same Folder as the program set in parameter 3)
6 Parameters If you want to launch the program with command line parameters, write them here
7 IconFile Specify which icon to use on the shortcut. (No need to give path if IconFile is in same folder as the program set in parameter 3)
(Path\) IconFile - for icon type .ico or .exe
(Path\) IconFile#$cIndex* - for icon type .dll or .exe (simply add #$c between IconFile and Index)
8 StartMode Optional value to set how the window of the launched program should be.
1 - Show
2 - Show_Minimized (program will start minimized)
3 - Show_Maximized (program will start maximized)
9 ToolTipText* Text to display when cursor is on the icon of the program

Remarks

  • Add_Shortcut is a generic command that will create a shortcut. On most projects, by leaving empty parameter 2, it will create this shortcut inside the Start Menu and will place it inside a subfolder that has the same name as the folder where the respective script is placed.
  • You don't need to worry where the shortcut will be placed because each project will create them in the best possible way.
  • This seems that it was coded exclusively to work with the explorer shell but it wasn't. If the user prefers (for example) to use xoblite, then the Add_Shortcut will either use the equivalent shortcut or simply ignore the request if it is not possible to execute.

Tips

If you want place an icon in StartMenu\Programs without subfolder use a point (.) as parameter 2

Add_Shortcut,StartMenu,.
Add_Shortcut,StartMenu,..

is same as

Add_Shortcut,StartMenuRoot

Example

For a script called Test.script, located in folder Apps\CD\ProgTest\ like this :

[Variables]
%ProgramTitle%=Test
%ProgramEXE%=Prog.exe
%ProgramFolder%=AppTest

[Process]
...

you can add a shortcut called Test in StartMenu\Programs\CD\ProgTest for the executable Program Files\AppTest\Prog.exe by using:

Add_Shortcut

or

Add_Shortcut,StartMenu

To use icon Icon.ico from same folder as the %ProgramExe%, use

Add_Shortcut,StartMenu,,,,,,Icon.ico

or to use icon from I386\sytem32\shell32.dll with index 27, use

Add_Shortcut,Desktop,,,,,,#$pSystemRoot#$p\system32\shell32.dll#$c27