addDesktopIcon

>>-addDesktopIcon--(--name--,--program--+--------------------------------+-->
                                        |                     +-0------+ |
                                        +-,--+----------+--,--+--------+-+
                                             +-iconfile-+     +-iconnr-+

>--+--------------------------------------------------------------------------+-)-><
   |                 +-"PERSONAL"-+                           +-"NORMAL"----+ |
   +-,-+---------+-,-+------------+-,-+------+-,-+--------+-,-+-------------+-+
       +-workdir-+   +-"COMMON"---+   +-args-+   +-hotkey-+   +-"MAXIMIZED"-+
                                                              +-"MINIMIZED"-+

Adds a shortcut to the Windows desktop. A sample program DESKICON.REX is provided in the ooRexx\SAMPLES directory.

Arguments:

The arguments are:

name

The name of the shortcut, displayed below the icon.

program

The program file launched by the shortcut.

iconfile

The name of the icon used for the shortcut. If not specified, the icon of program is used.

iconnr

The number of the icon within the iconfile. The default is 0.

workdir

The working directory of the shortcut.

location

Either of the following locations:

"PERSONAL"

The shortcut is personal and displayed only on the desktop of the user.

"COMMON"

The shortcut is common to all users and displayed on the desktop of all users.

args

The arguments passed to the program that the shortcut refers to.

hotkey

The virtual key to be used as a hotkey to open the shortcut. For a list of the key names, see Symbolic Names for Virtual Keys.

run

Specifies one of the options listed in the syntax diagram. The default is "NORMAL".