Table Shortcut
La table Shortcut contient les informations dont l’application a besoin pour créer des raccourcis sur l’ordinateur de l’utilisateur.
La table Shortcut comporte les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Raccourci | Identificateur | O | N |
| Directory_ | Identificateur | N | N |
| Nom | Nom du fichier | N | N |
| Component_ | Identificateur | N | N |
| Cible | Raccourci | N | N |
| Arguments | Formatted | N | O |
| Description | Text | N | O |
| Touche d’accès rapide | Integer | N | O |
| Icon_ | Identificateur | N | O |
| IconIndex | Integer | N | O |
| ShowCmd | Integer | N | O |
| WkDir | Identificateur | N | O |
| DisplayResourceDLL | Formatted | N | O |
| DisplayResourceId | Integer | N | O |
| DescriptionResourceDLL | Formatted | N | O |
| DescriptionResourceId | Integer | N | O |
Colonnes
-
Raccourci
-
Valeur de clé de cette table.
-
Directory_
-
Clé externe de la première colonne de la table Directory. Cette colonne spécifie le répertoire dans lequel le fichier Shortcut est créé.
-
Name
-
Nom localisable du raccourci à créer.
-
Component_
-
Clé externe de la première colonne de la table Component. Le programme d’installation utilise l’état d’installation du composant spécifié dans cette colonne pour déterminer si le raccourci est créé ou supprimé. Ce composant doit posséder un chemin de clé valide pour que le raccourci puisse être installé. Si la colonne Target contient le nom d’une fonctionnalité, le fichier lancé par le raccourci est le fichier de clé du composant figurant dans cette colonne.
-
Target
-
Cible du raccourci.
Pour un raccourci publié, cette colonne doit être une clé externe de la première colonne de la table Feature. Le programme d’installation évalue l’entrée présente dans le champ Target comme un identificateur. L’entrée doit être une clé étrangère valide de la table Feature. Le fichier lancé par le raccourci correspond dans ce cas au fichier de clé du composant figurant dans la colonne Component_. Lorsque le raccourci est activé, le programme d’installation vérifie que tous les composants de la fonctionnalité sont installés avant de lancer ce fichier.
Pour un raccourci non publié, le programme d’installation évalue ce champ comme une chaîne Formatted. Le champ doit contenir un identificateur de propriété placé entre crochets ([ ]), qui est développé dans le fichier ou le dossier vers lequel pointe le raccourci. Pour plus d’informations, consultez Action CreateShortcuts.
-
Arguments
-
Arguments de ligne de commande du raccourci.
Il est à noter que la résolution des propriétés du champ Arguments est limitée. Une propriété au format [Propriété] de ce champ ne peut être résolue que si elle possède déjà la valeur prévue lors de l’installation du composant qui gère le raccourci. Il faut par exemple, pour que l’argument « [#MonDocument.doc] » soit résolu correctement, que le même processus installe le fichier MonDocument.doc et le composant propriétaire du raccourci.
-
Description
-
Description localisable du raccourci.
-
Hotkey
-
Touche d’accès rapide du raccourci. L’octet d’ordre inférieur contient le code de clé virtuelle de la clé, tandis que l’octet d’ordre supérieur comporte des indicateurs de modification. Il doit s’agir d’un nombre non négatif. Il est généralement recommandé aux auteurs de packages d’installation de ne pas définir cette option, car cela peut ajouter des touches d’accès rapide en double au bureau d’un utilisateur. En outre, la pratique qui consiste à ajouter des touches d’accès rapide aux raccourcis risque de se révéler problématique pour les utilisateurs qui utilisent ces touches à des fins d’accessibilité.
-
Icon_
-
Clé externe de la première colonne de la table Icon.
-
IconIndex
-
Index de l’icône du raccourci. Il doit s’agir d’un nombre non négatif.
-
ShowCmd
-
Commande Afficher de la fenêtre d’application.
Vous pouvez utiliser les valeurs suivantes. Elles sont définies pour la fonction d’API Windows ShowWindow.
Valeur Signification 1 SW_SHOWNORMAL 3 SW_SHOWMAXIMIZED 7 SW_SHOWMINNOACTIVE -
WkDir
-
Nom de la propriété comportant le chemin du répertoire de travail du raccourci. La valeur peut suivre le format Windows pour faire référence à des variables d’environnement, par exemple %USERPROFILE%. Les références sont traduites en un chemin réel lorsque le programme d’installation résout le répertoire de travail pour créer le raccourci.
-
DisplayResourceDLL
-
Ce champ contient la valeur de chaîne Formatted du chemin complet de l’exécutable portable indépendant de la langue (fichier LN) qui contient les données de configuration de ressources (configuration RC). La chaîne mise en forme peut appliquer la convention [#filekey]. Si ce champ contient une valeur, la colonne Name est ignorée. S’il est vide, le programme d’installation utilise la valeur présente dans la colonne Name. Lorsque ce champ contient une valeur, le champ DisplayResourceId doit également comporter une valeur. À défaut, l’installation échoue.
Cette colonne de la table Shortcut n’est utilisée qu’en cas d’exécution sur Windows Vista ou Windows Server 2008. Elle est sinon ignorée. Elle est disponible à partir de la version 4.0 de Windows Installer.
Pour plus d’informations sur l’ajout à la table Shortcut de raccourcis utilisables avec des ressources MUI, consultez Exemple de raccourci MUI.
-
DisplayResourceId
-
Nom complet du raccourci. Il doit s’agir d’un nombre non négatif. Lorsque ce champ contient une valeur, le champ DisplayResourceDLL doit également comporter une valeur. À défaut, l’installation échoue.
Cette colonne de la table Shortcut n’est utilisée qu’en cas d’exécution sur Windows Vista ou Windows Server 2008. Elle est sinon ignorée. Elle est disponible à partir de la version 4.0 de Windows Installer.
-
DescriptionResourceDLL
-
Ce champ contient la valeur de chaîne Formatted du chemin complet de l’exécutable portable indépendant de la langue (fichier LN) qui contient les données de configuration de ressources (configuration RC). La chaîne mise en forme peut appliquer la convention [#filekey]. Si ce champ contient une valeur, la colonne Name est ignorée. S’il est vide, le programme d’installation utilise la valeur présente dans la colonne Description. Lorsque ce champ contient une valeur, le champ DescriptionResourceId doit également comporter une valeur. À défaut, l’installation échoue.
Cette colonne de la table Shortcut n’est utilisée qu’en cas d’exécution sur Windows Vista ou Windows Server 2008. Elle est sinon ignorée. Elle est disponible à partir de la version 4.0 de Windows Installer.
Pour plus d’informations sur l’ajout à la table Shortcut de raccourcis utilisables avec des ressources MUI, consultez Exemple de raccourci MUI.
-
DescriptionResourceId
-
Index du nom de la description du raccourci. Il doit s’agir d’un nombre non négatif. Lorsque ce champ contient une valeur, le champ DescriptionResourceDLL doit également comporter une valeur. À défaut, l’installation échoue.
Cette colonne de la table Shortcut n’est utilisée qu’en cas d’exécution sur Windows Vista ou Windows Server 2008. Elle est sinon ignorée. Elle est disponible à partir de la version 4.0 de Windows Installer.
Notes
Le fait d’activer une fonctionnalité n’a pour effet de créer un raccourci publié que si l’interface IShellLink du système prend en charge la résolution du descripteur du programme d’installation. Cette option est compatible avec Microsoft Windows 2000 et les systèmes exécutant Microsoft Internet Explorer 4.01. Si elle n’est pas gérée, le programme d’installation crée un raccourci non publié lors de l’installation du composant de la fonctionnalité, localement ou par exécution à partir de la source.
Il est à noter que les raccourcis publiés pointent toujours vers une application particulière, identifiée par un ProductCode. Ils ne doivent pas être partagés entre les applications. Ils fonctionnent uniquement pour l’application la plus récemment installée, et sont supprimés dès que celle-ci est retirée.
L’exécution de l’action CreateShortcuts et de l’action RemoveShortcuts donne lieu à une référence à cette table.
Consultez également la propriété DISABLEADVTSHORTCUTS.
Validation