Tableau de raccourcis
Le tableau de raccourcis contient les informations dont l’application a besoin pour créer des raccourcis sur l’ordinateur de l’utilisateur.
Le tableau de raccourcis contient les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Raccourci | Identificateur | O | N |
| Répertoire_ | Identificateur | N | N |
| Nom | Nom du fichier | N | N |
| Composant_ | Identificateur | N | N |
| Cible | Raccourci | N | N |
| Arguments | Correct | N | O |
| Description | Text | N | O |
| Touche d’accès rapide | Integer | N | O |
| Située_ | Identificateur | N | O |
| IndexIcône | Integer | N | O |
| ShowCmd | Integer | N | O |
| WkDir | Identificateur | N | O |
| DisplayResourceDLL | Correct | N | O |
| DisplayResourceId | Integer | N | O |
| DescriptionResourceDLL | Correct | N | O |
| DescriptionResourceId | Integer | N | O |
Colonnes
-
Gestionnaires
-
Valeur de clé pour cette table.
-
Directory_
-
Clé externe dans la première colonne de la table de répertoires. Cette colonne spécifie le répertoire dans lequel le fichier de raccourci est créé.
-
Nomme
-
Nom localisable du raccourci à créer.
-
-_
-
Clé externe dans la première colonne de la table de composants. 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 d’accès de clé valide pour l’installation du raccourci. Si la colonne cible contient le nom d’une fonctionnalité, le fichier lancé par le raccourci est le fichier de clé du composant indiqué dans cet article.
-
Indicatif
-
Cible de raccourci.
Pour un raccourci publié, cette colonne doit être une clé externe dans la première colonne du tableau des fonctionnalités. Le programme d’installation évalue l’entrée dans le champ cible en tant qu' identificateur et l’entrée doit être une clé étrangère valide dans la table des fonctionnalités. Dans ce cas, le fichier lancé par le raccourci est le fichier de clé du composant listé dans la _ colonne composant. 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 mise en forme . Le champ doit contenir un identificateur de propriété entouré de crochets ( [ ] ), qui est développé dans le fichier ou dans un dossier désigné 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 en tant que [ propriété ] dans ce champ ne peut être résolue que si la propriété a déjà la valeur prévue lorsque le composant qui possède le raccourci est installé. Par exemple, pour résoudre la valeur correcte pour l’argument « [ #MyDoc.doc] », le même processus doit installer le fichier MyDoc.doc et le composant qui possède le raccourci.
-
Descriptive
-
Description localisable du raccourci.
-
Séquence
-
Raccourci clavier du raccourci. L’octet de poids faible contient le code de touche virtuelle pour la clé, et l’octet de poids fort contient des indicateurs de modificateur. Il doit s’agir d’un nombre non négatif. Les auteurs des packages d’installation sont généralement recommandés pour ne pas définir cette option, car le paramètre de cette option peut ajouter des touches d’activation en double sur le Bureau d’un utilisateur. En outre, la pratique consistant à assigner des touches d’accès rapide aux raccourcis peut être problématique pour les utilisateurs qui utilisent des touches d’accès rapide pour l' accessibilité.
-
Située_
-
Clé externe de la colonne de l’une des tables d’icônes.
-
IndexIcône
-
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 d’API Windows ShowWindow.
Valeur Signification 1 _SHOWNORMAL SW 3 _SHOWMAXIMIZED SW 7 _SHOWMINNOACTIVE SW -
WkDir
-
Nom de la propriété qui contient le chemin d’accès du répertoire de travail du 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 indépendant du langage (fichier LN) qui contient les données de configuration de ressource (RC config). La chaîne mise en forme peut utiliser la [ # ] Convention filekey. Si ce champ contient une valeur, la colonne de nom est ignorée. Si ce champ est vide, le programme d’installation utilise la valeur dans la colonne nom. Lorsque ce champ contient une valeur, le champ DisplayResourceId doit également contenir une valeur, sinon l’installation échoue.
cette colonne du tableau de raccourcis est utilisée uniquement lors de l’exécution sur Windows Vista ou Windows Server 2008 et elle est ignorée. cette colonne est disponible avec les versions antérieures à Windows Installer 4,0.
Pour plus d’informations sur l’ajout de raccourcis à une table de raccourcis pour une utilisation avec des ressources MUI, consultez un 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 doit également contenir une valeur, sinon l’installation échoue.
cette colonne du tableau de raccourcis est utilisée uniquement lors de l’exécution sur Windows Vista ou Windows Server 2008 et elle est ignorée. cette colonne est disponible avec les 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 indépendant du langage (fichier LN) qui contient les données de configuration de ressource (RC config). La chaîne mise en forme peut utiliser la [ # ] Convention filekey. Si ce champ contient une valeur, la colonne de nom 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 doit également contenir une valeur, sinon l’installation échoue.
cette colonne du tableau de raccourcis est utilisée uniquement lors de l’exécution sur Windows Vista ou Windows Server 2008 et elle est ignorée. cette colonne est disponible avec les versions antérieures à Windows Installer 4,0.
Pour plus d’informations sur l’ajout de raccourcis à une table de raccourcis pour une utilisation avec des ressources MUI, consultez un 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 doit également contenir une valeur, sinon l’installation échoue.
cette colonne du tableau de raccourcis est utilisée uniquement lors de l’exécution sur Windows Vista ou Windows Server 2008 et elle est ignorée. cette colonne est disponible avec les 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és par un ProductCode, et ne doivent pas être partagés entre les applications. Les raccourcis publiés ne fonctionnent que pour l’application la plus récemment installée, et sont supprimés lors de la suppression de cette dernière.
Cette table est référencée lorsque l' action CreateShortcuts et l' action RemoveShortcuts sont exécutées.
Consultez également la propriété DISABLEADVTSHORTCUTS .