.. highlightlang:: us

.. _shell_createshortcut:

Shell_CreateShortcut
====================

.. index:: Shell_CreateShortcut

.. us.tag  Shell_CreateShortcut NOTREADYENGLISH FILE_MISC New530

:ref:`Shell_CreateShortcut` creates a short cut to a program or file on the desktop,
in the program menu or in other places.

.. function::  bool = Shell_CreateShortcut(ssLinkTarget, ssArgs, ssLinkName, ssFolder, ssDescription, ssIconPath, nIconIndex)

.. us.return

**Return Value**

*bool*

.. us.params

**Parameters**

.. uparam:: ssLinkTarget

   *ssLinkTarget* is the target, for example ``GetRootDirectory() +  "program/uniplot.exe"``.

.. uparam:: ssArgs

   *ssArgs* are the command parameters. Can be empty.

.. uparam:: ssLinkName

   *ssLinkName* is the link name, for example ``UniPlot 5.2``.

.. uparam:: ssFolder

   *ssFolder* is the directory, see :ref:`Shell_GetSpecialFolder`.

.. uparam:: ssDescription

   *ssDescription* is a description of the link.

.. uparam:: ssIconPath

   *ssIconPath* is the complete path to the exe file or DLL with the icon,
   for example ``GetRootDirectory() +  "program/uniplot.exe"``.

.. uparam:: nIconIndex

   *nIconIndex* is the index of the icon (0 for the first icon).

.. us.example

**Example**

::

   ssUniPlot = GetRootDirectory() +  "program/uniplot.exe";
   ssFolder = Shell_GetSpecialFolder(2); // Start Menu\Programs
   print Shell_CreateShortcut(ssUniPlot, "", "UniPlot-5.2.1", ..
                              ssFolder, "", ssUniPlot, 0);

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.3.0
     - New.

.. seealso::
   :ref:`overview-files`,
   :ref:`Shell_GetSpecialFolder`

:sub:`id-361107`