↑  ←  Описание функции


FileCreateShortcut

Создаёт ярлык (.lnk) к файлу.

FileCreateShortcut ( "file", "lnk" [, "workdir" [, "args" [, "desc" [, "icon" [, "hotkey" [, icon number [, state ]]]]]]] )

Параметры

file Полный путь к файлу (объект запуска).
lnk Полный путь к файлу-ярлыку, который будет создан.
workdir [необязательный] Рабочий каталог.
args [необязательный] Параметры командной строки, передаваемые файлу.
desc [необязательный] Описание, отображается во всплывающей подсказке.
icon [необязательный] Имя или путь к файлу с иконкой (ico, dll, exe и др.).
hotkey [необязательный] Горячая клавиша - формат такой же, как и в функции Send().
icon number [необязательный] Номер иконки для использования (обычно 0)
state [необязательный] Состояние окна при запуске. Используйте @SW_SHOWNORMAL, @SW_SHOWMINNOACTIVE или @SW_SHOWMAXIMIZED

Возвращаемое значение

Успех:Возвращает 1.
Ошибка:Возвращает 0, если ярлык не может быть создан.

Примечания

Горячие клавиши для ярлыков в Windows могут быть следующей формы: Ctrl+Alt+X, Ctrl+Shift+X, Shift+Alt+X, Ctrl+NumPadKey или Alt+NumPadKey, где X - это буква, цифра, знак препинания или функциональная клавиша. Если выбрана неправильная форма, Windows обычно использует Ctrl+Alt.
Обратите внимание, что Windows отличает боковые цифровые клавиши от обычных цифровых и пунктуационных клавиш. FileCreateShortcut() позволяет создать сочетания Ctrl+X и Alt+X для ярлыков (которые Windows обычно позволяет использовать, только если X, это клавиша NumPadKey), однако, следует избегать таких присвоений, поскольку это может вызывать конфликт со стандартными горячими клавишами приложений.

Windows запрещает использование ESC, ENTER, TAB, SPACEBAR, PRINT SCREEN, SHIFT или BACKSPACE в качестве горячих клавиш.

FileCreateShortcut() не требует корректных параметров file, workdir, icon или hotkey для успешного создания файла ярлыка. Однако путь к файлу ярлыка (lnk) должен быть корректным! Если будет выбрана уже занятая горячая клавиша, новый ярлык получит приоритет выше. Так же, если файл ярлыка (параметр lnk) уже существует, это приведет к его перезаписи.

См. также

FileGetShortcut, FileCreateNTFSLink

Пример

; Создаёт ярлык и назначает ему горячую клавишу Ctrl+Alt+t
FileCreateShortcut(@WindowsDir & "\Explorer.exe", @DesktopDir & "\Тестовый ярлык.lnk", @WindowsDir, "/e,c:\", "Это ссылка на Проводник ;-)", @SystemDir & "\shell32.dll", "^!t", "15", @SW_MINIMIZE)