Поделиться через


Ярлык таблицы

В таблице ярлыков содержатся сведения, необходимые приложению для создания ярлыков на компьютере пользователя.

Таблица ярлыков содержит следующие столбцы.

Столбец Тип Ключ Допустимое значение NULL
Ярлык идентификатора Y N
Каталог_ идентификатора N N
Имя имя файла N N
Компонент_ идентификатора N N
Цель ярлык N N
Аргументы Форматированные N Y
Описание текста N Y
Горячая клавиша целочисленного N Y
Икона_ идентификатора N Y
IconIndex целочисленного N Y
ShowCmd целочисленного N Y
WkDir идентификатора N Y
DisplayResourceDLL Форматированные N Y
DisplayResourceId целочисленного N Y
DescriptionResourceDLL Форматированные N Y
DescriptionResourceId целочисленного N Y

 

Столбцы

Ярлык

Ключевое значение для этой таблицы.

Directory_

Внешний ключ в первом столбце таблицы каталога . Этот столбец указывает каталог, в котором создается ярлыковый файл.

имя

Локализованное имя создаваемого ярлыка.

Component_

Внешний ключ в первом столбце таблицы компонентов . Установщик использует состояние установки компонента, указанного в этом столбце, чтобы определить, создается ли ярлык или удаляется. Этот компонент должен иметь допустимый путь к ключу для установки ярлыка. Если целевой столбец содержит имя компонента, файл, запущенный ярлыком, является ключевым файлом компонента, перечисленным в этом столбце.

Целевой объект

Целевой объект ярлыка.

Для объявленного ярлыка этот столбец должен быть внешним ключом в первом столбце таблицы компонентов . Установщик вычисляет запись в поле "Целевой" как идентификатор , а запись должна быть допустимым внешним ключом в таблице компонентов . Файл, запущенный ярлыком в этом случае, является ключевым файлом компонента, перечисленным в столбце Component_. При активации ярлыка установщик проверяет, установлены ли все компоненты компонента перед запуском этого файла.

Для нерекомендационного ярлыка установщик вычисляет это поле как строку форматирования. Поле должно содержать идентификатор свойства, заключенный в квадратные скобки ([ ]), который расширяется в файл или папку, на которую указывает ярлык. Дополнительные сведения см. в действии CreateShortcuts.

Аргументы

Аргументы командной строки для ярлыка.

Обратите внимание, что разрешение свойств в поле "Аргументы" ограничено. Свойство, отформатированное как [Свойство] в этом поле, можно разрешить только в том случае, если свойство уже имеет предполагаемое значение при установке компонента, которому принадлежит ярлык. Например, чтобы разрешить правильное значение аргумента "[#MyDoc.doc], то же самое необходимо установить файл MyDoc.doc и компонент, принадлежащий ярлыку.

описание

Локализованное описание ярлыка.

горячий ключ

Горячий ключ для ярлыка. Байт низкого порядка содержит код виртуального ключа для ключа, а байт высокого порядка содержит флаги модификатора. Это должно быть не отрицательное число. Авторы пакетов установки, как правило, не рекомендуется задавать этот параметр, так как параметр этого параметра может добавлять повторяющиеся горячие ключи на рабочий стол пользователя. Кроме того, практика назначения горячих ключей ярлыкам может быть проблематичной для пользователей, использующих горячие ключи для специальных возможностей.

Icon_

Внешний ключ к столбцу одной из таблицы значков .

IconIndex

Индекс значка для ярлыка. Это должно быть не отрицательное число.

ShowCmd

Команда Show для окна приложения.

Можно использовать следующие значения. Значения определяются для функции API Windows ShowWindow.

Ценность Значение
1 SW_SHOWNORMAL
3 SW_SHOWMAXIMIZED
7 SW_SHOWMINNOACTIVE

 

WkDir

Имя свойства, имеющего путь к рабочему каталогу для ярлыка. Значение может использовать формат Windows для ссылки на переменные среды, например %USERPROFILE%. Ссылки разрешаются на фактический путь, когда установщик разрешает рабочий каталог для создания ярлыка.

DisplayResourceDLL

Это поле содержит строковое значение форматированного для полного пути к переносимому исполняемому файлу с нейтральным языком (LN-файл), который содержит данные конфигурации ресурсов (RC Config). Форматированная строка может использовать соглашение [#filekey]. Если это поле содержит значение, столбец Name игнорируется. Если это поле пусто, установщик использует значение в столбце "Имя". Если это поле содержит значение, поле DisplayResourceId также требуется для хранения значения или сбой установки.

Этот столбец таблицы ярлыков используется только при запуске в Windows Vista или Windows Server 2008 и в противном случае игнорируется. Этот столбец доступен с версиями, не предшествующими установщику Windows 4.0.

Сведения о добавлении ярлыков в таблицу ярлыков для использования с ресурсами MUI см. в разделе Пример сочетания клавиш MUI.

DisplayResourceId

Индекс отображаемого имени для ярлыка. Это должно быть не отрицательное число. Если это поле содержит значение, поле DisplayResourceDLL необходимо также содержать значение или сбой установки.

Этот столбец таблицы ярлыков используется только при запуске в Windows Vista или Windows Server 2008 и в противном случае игнорируется. Этот столбец доступен с версиями, не предшествующими установщику Windows 4.0.

DescriptionResourceDLL

Это поле содержит строковое значение форматированного для полного пути к переносимому исполняемому файлу с нейтральным языком (LN-файл), который содержит данные конфигурации ресурсов (RC Config). Форматированная строка может использовать соглашение [#filekey]. Если это поле содержит значение, столбец Name игнорируется. Если это поле пусто, установщик использует значение в столбце Description. Если это поле содержит значение, поле 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 Explorer 4.01. Если он не поддерживается, установщик создает нерекомендаемый ярлык при установке компонента либо локально, либо из источника.

Обратите внимание, что объявленные ярлыки всегда указывают на определенное приложение, определяемое ProductCode, и не должны совместно использоваться между приложениями. Объявленные ярлыки работают только для последнего установленного приложения и удаляются при удалении этого приложения.

Эта таблица ссылается на действие CreateShortcuts и действие removeShortcuts RemoveShortcuts.

См. также свойство DISABLEADVTSHORTCUTS.

Ратификация

ICE03
ICE06
ICE19
ICE32
ICE36
ICE46
ICE50
ICE57
ICE59
ICE67
ICE69
ICE80
ICE90
ICE91
ICE94