Shell.CreateShortcut

Shell.CreateShortcut ( string Folder,
string Description,
string Target,
string CmdLine = "",
string WorkingFolder = "",
string IconPath = "",
number IconIndex = 0,
number WindowMode = SW_SHOWNORMAL,
table HotKey = nil )
Примеры

Описание

Создает ярлык в системе пользователя.

Примечание: Если целевой диск не существует или недоступен, путь к папке в ярлыке будет усечен до восьми символов. Для получения дополнительной информации смотрите статью Microsoft Q263324.

Параметры

Folder

(строка) Путь к папке, где будет создан ярлык.

Description

(строка) Надпись, которая будет дана ярлыку. Это будет "названием (именем)" ярлыка — то есть тем, что будет видеть пользователь.

Target

(строка) Полный путь и имя файла или папки, на который будет указывать ярлык.

CmdLine

(строка) Аргументы командной строки (если таковые имеются), которые будут переданы файлу, связанную с ярлыком.

WorkingFolder

(строка) Рабочая директория, где будет храниться файл, на который указывает ярлык.

IconPath

(строка) Полный путь к файлу, содержащему иконку, используемую ярлыком. Наиболее распространенными типами файлов являются файлы иконок (.ico) и исполняемые файлы (.exe). Если путь иконки не указан, взамен будет взята иконка из целевого файла.

IconIndex

(число) Начинающийся с нуля индекс показывающий какая иконка используется в файле. Например, индекс иконки 2 означает что будет использоваться третья иконка в файле. Если же в файле только одна иконка, или нужно использовать первую найденную иконку, укажите значение 0.

WindowMode

(число) Режим окна запускаемого файла. Выбор из:

КОНСТАНТА
CONSTANT
ЗНАЧЕНИЕ
VALUE
ОПИСАНИЕ
DESCRIPTION
SW_SHOWNORMAL1Файл будет запущен в обычном окне.
SW_MAXIMIZE3Файл будет запущен в развернутом на весь экран виде.
SW_SHOWMINNOACTIVE7Файл будет запущен свернутым.

HotKey

(таблица) Таблица, содержащая дополнительные системные комбинации клавиш, которые будет запускать ярлык, индексированная следующими ключами:

КЛЮЧ
KEY
ТИП
TYPE
ОПИСАНИЕ
DESCRIPTION
shiftлогическийДелать ли нажатие управляющей клавиши "shift" частью комбинации клавиш. Значение true (истина) означает что клавиша была нажата, а значение false (ложь) - что нажатия не было. Это значение можно получить как tb.shift.
ctrlлогическийДелать ли нажатие управляющей клавиши "ctrl" частью комбинации клавиш. Значение true (истина) означает что клавиша была нажата, а значение false (ложь) - что нажатия не было. Это значение можно получить как tb.ctrl.
altлогическийДелать ли нажатие управляющей клавиши "alt" частью комбинации клавиш. Значение true (истина) означает что клавиша была нажата, а значение false (ложь) - что нажатия не было. Это значение можно получить как tb.alt.
keycodeчислоВиртуальный код клавиши которая была нажата. Это значение можно получить как tb.keycode.

Примечание: Если не нужно добавлять "горячие" клавиши для ярлыка, нужно передать значение nil (nil - это значение по умолчанию).

Возврат

Ничего. Можно использовать действие Application.GetLastError для определения случился ли отказ в работе этого действия и почему.
Смотрите также: Связанные действия

Примеры

Пример 1

Shell.CreateShortcut(_DesktopFolder, "My Shortcut", "C:\\Program Files\\MyApp\\app.exe", "", "", "C:\\Program Files\\MyApp\\myicon.ico", 0, SW_MAXIMIZE, nil);
Создаем ярлык на Рабочем столе пользователя с файлом иконки "myicon.ico" и надписью "My Shortcut". Ярлык устанавливается для указания на файл "app.exe" и будет запускать его в "развернутом" режиме окна.

Примечание: _DesktopFolder это встроенная переменная которая содержит путь к папке "Рабочий стол" пользователя.

Пример 2

Shell.CreateShortcut(_DesktopFolder, "My Shortcut", "C:\\Program Files\\MyApp\\app.exe", "", "", "C:\\Program Files\\MyApp\\myicon.ico", 0, SW_MAXIMIZE, {shift = true, ctrl = true, keycode = 72});
Создаем ярлык на Рабочем столе пользователя с файлом иконки "myicon.ico" и надписью "My Shortcut". Ярлык устанавливается для указания на файл "app.exe" и будет запускать его в "развернутом" режиме окна. Для ярлыка также назначены "горячие" клавиши, так что при удержании в нажатом положении клавиш shift, alt и нажатии на клавишу "h" (виртуальный код клавиши 72) будет запущено приложение указанное ярлыком.

Примечание: _DesktopFolder это встроенная переменная которая содержит путь к папке "Рабочий стол" пользователя.
Смотрите также: Связанные действия