Ярлык таблицы
В таблице ярлыков содержатся сведения, необходимые приложению для создания ярлыков на компьютере пользователя.
Таблица ярлыков содержит следующие столбцы.
| Столбец | Тип | Ключ | Допустимое значение 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.
Ратификация