Table de raccourcis
La table Raccourci contient les informations dont l’application a besoin pour créer des raccourcis sur l’ordinateur de l’utilisateur.
Le tableau de raccourcis comporte les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Raccourci | identificateur | Y | N |
| Répertoire_ | identificateur | N | N |
| Nom | nom de fichier | N | N |
| Composant_ | identificateur | N | N |
| Cible | raccourci | N | N |
| Arguments | mise en forme | N | Y |
| Description | texte | N | Y |
| Hotkey | entier | N | Y |
| Icône_ | identificateur | N | Y |
| IconIndex | entier | N | Y |
| ShowCmd | entier | N | Y |
| WkDir | identificateur | N | Y |
| DisplayResourceDLL | mise en forme | N | Y |
| DisplayResourceId | entier | N | Y |
| DescriptionResourceDLL | mise en forme | N | Y |
| DescriptionResourceId | entier | N | Y |
Colonnes
-
raccourci
-
Valeur de clé de cette table.
-
Directory_
-
Clé externe dans la première colonne de la table Directory. Cette colonne spécifie le répertoire dans lequel le fichier de raccourci est créé.
-
nom de
-
Nom localisable du raccourci à créer.
-
Component_
-
Clé externe dans la première colonne de la table composant . 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 avoir un chemin de touche valide pour que le raccourci soit installé. Si la colonne Cible contient le nom d’une fonctionnalité, le fichier lancé par le raccourci est le fichier clé du composant répertorié dans cette colonne.
-
cible
-
Cible de raccourci.
Pour un raccourci publié, cette colonne doit être une clé externe dans la première colonne de la table de fonctionnalités . Le programme d’installation évalue l’entrée dans le champ Cible en tant que Identificateur et l’entrée doit être une clé étrangère valide dans la table de fonctionnalités . Le fichier lancé par le raccourci dans ce cas est le fichier clé du composant répertorié 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 de mise en forme. Le champ doit contenir un identificateur de propriété placé entre crochets ([ ]), développé dans le fichier ou un dossier pointé par le raccourci. Pour plus d’informations, consultez l''action CreateShortcuts.
-
arguments
-
Arguments de ligne de commande pour le raccourci.
Notez que la résolution des propriétés dans le champ Arguments est limitée. Une propriété mise en forme comme [Property] dans ce champ ne peut être résolue que si la propriété a déjà la valeur prévue lorsque le composant propriétaire du raccourci est installé. Par exemple, pour résoudre la valeur correcte de l’argument « [#MyDoc.doc] », le même processus doit installer le fichier MyDoc.doc et le composant propriétaire du raccourci.
-
Description
-
Description localisable du raccourci.
-
touche d’accès rapide
-
Touche d’accès rapide pour le raccourci. L’octet de faible ordre contient le code de clé virtuelle de la clé, et l’octet de classement élevé contient des indicateurs de modificateur. Il doit s’agir d’un nombre non négatif. Les auteurs de packages d’installation sont généralement recommandés de ne pas définir cette option, car le paramètre de cette option peut ajouter des touches d’accès rapide dupliquées au bureau d’un utilisateur. En outre, la pratique d’attribuer des touches d’accès à des raccourcis peut poser problème pour les utilisateurs qui utilisent des touches d’accès pour d’accessibilité.
-
Icon_
-
Clé externe à la colonne de l’une des table Icône.
-
IconIndex
-
Index d’icône pour le raccourci. Il doit s’agir d’un nombre non négatif.
-
ShowCmd
-
Commande Show pour la fenêtre d’application.
Les valeurs suivantes peuvent être utilisées. Les valeurs sont définies pour la fonction API Windows ShowWindow.
Valeur Signification 1 SW_SHOWNORMAL 3 SW_SHOWMAXIMIZED 7 SW_SHOWMINNOACTIVE -
WkDir
-
Nom de la propriété qui a le chemin d’accès du répertoire de travail pour le raccourci. La valeur peut utiliser le format Windows pour référencer des variables d’environnement, par exemple %USERPROFILE%. Les références sont résolues en chemin d’accès réel lorsque le programme d’installation résout le répertoire de travail pour créer le raccourci.
-
DisplayResourceDLL
-
Ce champ contient une valeur de chaîne mise en forme pour le chemin d’accès complet au fichier exécutable portable neutre en langage qui contient les données de configuration de ressource (CONFIGURATION RC). La chaîne mise en forme peut utiliser la convention [#filekey]. Si ce champ contient une valeur, la colonne Name est ignorée. Si ce champ est vide, le programme d’installation utilise la valeur dans la colonne Name. Lorsque ce champ contient une valeur, le champ DisplayResourceId est également nécessaire pour contenir une valeur ou l’installation échoue.
Cette colonne de la table de raccourcis est utilisée uniquement lors de l’exécution sur Windows Vista ou Windows Server 2008 et est sinon ignorée. Cette colonne est disponible avec des versions antérieures à Windows Installer 4.0.
Pour plus d’informations sur l’ajout de raccourcis à la table de raccourcis à utiliser avec les ressources MUI, consultez 'exemple de raccourci MUI.
-
DisplayResourceId
-
Index du nom complet du raccourci. Il doit s’agir d’un nombre non négatif. Lorsque ce champ contient une valeur, le champ DisplayResourceDLL est requis pour contenir également une valeur ou l’installation échoue.
Cette colonne de la table de raccourcis est utilisée uniquement lors de l’exécution sur Windows Vista ou Windows Server 2008 et est sinon ignorée. Cette colonne est disponible avec des versions antérieures à Windows Installer 4.0.
-
DescriptionResourceDLL
-
Ce champ contient une valeur de chaîne mise en forme pour le chemin d’accès complet au fichier exécutable portable neutre en langage qui contient les données de configuration de ressource (CONFIGURATION RC). La chaîne mise en forme peut utiliser la convention [#filekey]. Si ce champ contient une valeur, la colonne Name est ignorée. Si ce champ est vide, le programme d’installation utilise la valeur dans la colonne Description. Lorsque ce champ contient une valeur, le champ DescriptionResourceId est également nécessaire pour contenir une valeur ou l’installation échoue.
Cette colonne de la table de raccourcis est utilisée uniquement lors de l’exécution sur Windows Vista ou Windows Server 2008 et est sinon ignorée. Cette colonne est disponible avec des versions antérieures à Windows Installer 4.0.
Pour plus d’informations sur l’ajout de raccourcis à la table de raccourcis à utiliser avec les ressources MUI, consultez 'exemple de raccourci MUI.
-
DescriptionResourceId
-
Index du nom de description pour le raccourci. Il doit s’agir d’un nombre non négatif. Lorsque ce champ contient une valeur, le champ DescriptionResourceDLL est requis pour contenir également une valeur ou l’installation échoue.
Cette colonne de la table de raccourcis est utilisée uniquement lors de l’exécution sur Windows Vista ou Windows Server 2008 et est sinon ignorée. Cette colonne est disponible avec des versions antérieures à Windows Installer 4.0.
Remarques
L’activation d’une fonctionnalité crée un raccourci publié uniquement si l’interface IShellLink du système prend en charge la résolution du descripteur du programme d’installation. Cela est pris en charge par Microsoft Windows 2000 et les systèmes exécutant Microsoft Internet Explorer 4.01. S’il n’est pas pris en charge, le programme d’installation crée un raccourci non publié lors de l’installation du composant de la fonctionnalité, localement ou exécuté à partir de la source.
Notez que les raccourcis publiés pointent toujours vers une application particulière, identifiée par un ProductCode, et ne doivent pas être partagées entre les applications. Les raccourcis publiés fonctionnent uniquement pour l’application la plus récente installée et sont supprimés lorsque cette application est supprimée.
Cette table est référencée lorsque l’action CreateShortcuts et que l’action RemoveShortcuts est exécutée.
Consultez également la propriété DISABLEADVTSHORTCUTS.
Validation