Таблица ярлыков
Таблица ярлыков содержит сведения, необходимые приложению для создания ярлыков на компьютере пользователя.
Таблица ярлыков содержит следующие столбцы.
| Столбец | Type | Ключ | Допускает значения NULL |
|---|---|---|---|
| Клавиша | Идентификатор | Да | Нет |
| Каталог_ | Идентификатор | Нет | Нет |
| Имя | Имя файла | N | Нет |
| Компонент_ | Идентификатор | N | Нет |
| Назначение | Клавиша | N | N |
| Аргументы | Форматированные | N | Да |
| Описание | Text | N | Да |
| Сочетание клавиш | Целое число | N | Да |
| Значок_ | Идентификатор | N | Да |
| IconIndex | Целое число | N | Да |
| ShowCmd | Целое число | N | Да |
| WkDir | Идентификатор | N | Да |
| DisplayResourceDLL | Форматированные | Нет | Да |
| DisplayResourceId | Целое число | N | Да |
| DescriptionResourceDLL | Форматированные | Нет | Да |
| DescriptionResourceId | Целое число | N | Да |
Столбцы
-
Контекстное
-
Значение ключа для этой таблицы.
-
Каталог_
-
Внешний ключ в первом столбце таблицы Directory. В этом столбце указывается каталог, в котором создается файл ярлыка.
-
Имя
-
Локализуемое имя создаваемого ярлыка.
-
Компонент_
-
Внешний ключ в первом столбце таблицы Component. Установщик использует состояние установки компонента, указанного в этом столбце, чтобы определить, создан или удален ярлык. Для установки ярлыка у этого компонента должен быть допустимый путь к ключу. Если столбец Целевой объект содержит имя компонента, файл, запускаемый ярлыком, является файлом ключа компонента, указанного в этом столбце.
-
Целевой
-
Целевой объект ярлыка.
Для объявленного ярлыка этот столбец должен быть внешним ключом в первом столбце таблицы Признаков. Установщик оценивает запись в поле Целевой объект как идентификатор , и запись должна быть допустимым внешним ключом в таблице признаков. Файл, запускаемый ярлыком в этом случае, является файлом ключа компонента, указанного в столбце Component_. При активации ярлыка установщик проверяет, установлены ли все компоненты компонента перед запуском этого файла.
Для нерекомещенного ярлыка установщик оценивает это поле как форматированную строку. Поле должно содержать идентификатор свойства, заключенный в квадратные скобки ([ ]), развернутый в файл или папку, на которую указывает ярлык. Дополнительные сведения см. в разделе Действие CreateShortcuts.
-
Аргументы
-
Аргументы командной строки для ярлыка.
Обратите внимание, что разрешение свойств в поле Аргументы ограничено. Свойство, отформатированное как [Свойство] в этом поле, может быть разрешено только в том случае, если свойство уже имеет предполагаемое значение при установке компонента, которому принадлежит ярлык. Например, чтобы разрешить правильное значение аргумента "[#MyDoc.doc]", необходимо установить файл MyDoc.doc и компонент, которому принадлежит ярлык.
-
Описание
-
Локализуемое описание ярлыка.
-
Горячая клавиша
-
Горячая клавиша для ярлыка. Байт низкого порядка содержит код виртуального ключа для ключа, а байт высокого порядка содержит флаги модификаторов. Это должно быть не отрицательное число. Авторам установочных пакетов обычно не рекомендуется задавать этот параметр, так как параметр этого параметра может добавлять повторяющиеся клавиши горячей клавиши на рабочий стол пользователя. Кроме того, практика назначения сочетаний клавиш может быть проблематичной для пользователей, использующих их для специальных возможностей.
-
Значок_
-
Внешний ключ к столбцу одного из таблиц Значков.
-
IconIndex
-
Индекс значка для ярлыка. Это должно быть не отрицательное число.
-
ShowCmd
-
Команда Показать для окна приложения.
Можно использовать следующие значения. Значения определяются для функции API Windows ShowWindow.
Значение Значение 1 SW_SHOWNORMAL 3 SW_SHOWMAXIMIZED 7 SW_SHOWMINNOACTIVE -
WkDir
-
Имя свойства, имеющего путь к рабочему каталогу ярлыка. Значение может использовать формат Windows для ссылки на переменные среды, например %USERPROFILE%. Ссылки разрешаются в фактический путь, когда установщик разрешает рабочий каталог для создания ярлыка.
-
DisplayResourceDLL
-
Это поле содержит строковое значение formatted для полного пути к не зависящим от языка переносимым исполняемым файлом (LN-файл), который содержит данные конфигурации ресурсов (RC Config). Форматированная строка может использовать соглашение [#filekey]. Если это поле содержит значение, столбец Имя игнорируется. Если это поле пусто, установщик использует значение в столбце Имя. Если это поле содержит значение, поле DisplayResourceId также должно содержать значение, или установка завершается сбоем.
Этот столбец таблицы ярлыков используется только при работе в Windows Vista или Windows Server 2008 и в противном случае игнорируется. Этот столбец доступен в версиях, не предшествующих установщику Windows 4.0.
Сведения о добавлении ярлыков в таблицу ярлыков для использования с ресурсами MUI см. в разделе Пример сочетания клавиш MUI.
-
DisplayResourceId
-
Индекс отображаемого имени для ярлыка. Это должно быть не отрицательное число. Если это поле содержит значение, поле DisplayResourceDLL также должно содержать значение, иначе установка завершится ошибкой.
Этот столбец таблицы ярлыков используется только при работе в Windows Vista или Windows Server 2008 и в противном случае игнорируется. Этот столбец доступен в версиях, не предшествующих установщику Windows 4.0.
-
ОписаниеResourceDLL
-
Это поле содержит строковое значение formatted для полного пути к не зависящим от языка переносимым исполняемым файлом (LN-файл), который содержит данные конфигурации ресурсов (RC Config). Форматированная строка может использовать соглашение [#filekey]. Если это поле содержит значение, столбец Имя игнорируется. Если это поле пусто, установщик использует значение в столбце Описание. Если это поле содержит значение, в поле DescriptionResourceId также требуется содержать значение, в противном случае установка завершается сбоем.
Этот столбец таблицы ярлыков используется только при работе в Windows Vista или Windows Server 2008 и в противном случае игнорируется. Этот столбец доступен в версиях, не предшествующих установщику Windows 4.0.
Сведения о добавлении ярлыков в таблицу ярлыков для использования с ресурсами MUI см. в разделе Пример сочетания клавиш MUI.
-
DescriptionResourceId
-
Индекс имени описания для ярлыка. Это должно быть не отрицательное число. Если это поле содержит значение, поле DescriptionResourceDLL также должно содержать значение, иначе установка завершится сбоем.
Этот столбец таблицы ярлыков используется только при работе в Windows Vista или Windows Server 2008 и в противном случае игнорируется. Этот столбец доступен в версиях, не предшествующих установщику Windows 4.0.
Комментарии
Включение функции создает объявленный ярлык, только если интерфейс IShellLink системы поддерживает разрешение дескрипторов установщика. Это поддерживается в Microsoft Windows 2000 и системах под управлением Microsoft Internet Обозреватель 4.01. Если он не поддерживается, установщик создает нерекламированный ярлык после установки компонента локально или из источника.
Обратите внимание, что объявленные ярлыки всегда указывают на определенное приложение, идентифицируемое в ProductCode, и не должны совместно использоваться приложениями. Объявленные ярлыки работают только для последнего установленного приложения и удаляются при удалении этого приложения.
Эта таблица упоминается при выполнении действий CreateShortcuts и RemoveShortcuts .
См. также свойство DISABLEADVTSHORTCUTS .
Проверка
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по