Identificateurs programmatiques
L’interpréteur de commandes utilise une sous-clé de Registre ProgID (Program Identifier) pour associer un type de fichier à une application et contrôler le comportement de l’association. Les entrées ProgID utilisées pour les associations de fichiers se trouvent sous HKEY_CLASSES_ROOT dans le Registre.
Cette rubrique est organisée comme suit :
- éléments d’identificateur programmatique utilisés par les associations de fichiers
- à l’aide d’identificateurs programmatiques avec version
- rubriques connexes
Pour plus d’informations, lisez Comment inscrire un type de fichier pour une nouvelle application
Éléments d’identificateur par programmation utilisés par les associations de fichiers
Le format approprié d’un nom de clé ProgID est [Vendor or Application]. [Component]. [Version], séparées par des points et sans espaces, comme dans Word.Document.6. La partie version est facultative, mais fortement recommandée. Pour plus d’informations, consultez Using Versioned Program Identifiers.
Une sous-clé ProgID doit inclure les éléments suivants. Notez que certaines données de chaîne de cette clé nécessitent une mise en forme spécifique.
| Élément | Description |
|---|---|
| (par défaut) | Définissez l’entrée par défaut de la sous-clé ProgID sur un nom convivial pour ce ProgID, adapté à l’affichage à l’utilisateur. L’utilisation de cette entrée pour contenir le nom convivial est déconseillée par l’entrée FriendlyTypeName sur les systèmes exécutant Windows 2000 ou version ultérieure. Toutefois, vous devez définir cette valeur pour la compatibilité descendante. |
| AllowSilentDefaultTakeOver (introduit dans Windows 8) | Définissez cette entrée facultative pour signaler que Windows doit ignorer ce ProgID lors de la détermination d’un gestionnaire par défaut pour un type de fichier public. Que cette valeur soit définie, le ProgID continue d’apparaître dans le menu contextuel OpenWith et la boîte de dialogue. Il s’agit d’une valeur REG_NONE. |
| appUserModelID (introduit dans Windows 7) | Définissez cette entrée facultative sur l’ID de modèle utilisateur d’application explicite de l’application (AppUserModelID) si l’application utilise un AppUserModelID explicite et utilise le récent ou Listes de raccourcis fréquentes ou fournit une liste de raccourcis personnalisée. Si une application utilise un AppUserModelID explicite et ne définit pas cette valeur, les éléments n’apparaissent pas dans les listes de raccourcis de cette application. Il s’agit d’une chaîne REG_SZ. Pour plus d’informations, consultez ID de modèle utilisateur d’application (AppUserModelIDs). |
| EditFlags | Définissez cette entrée facultative à l’aide d’indicateurs de l’énumération FILETYPEATTRIBUTEFLAGS. L’entrée EditFlags contrôle certains aspects de la gestion de l’interpréteur de commandes des types de fichiers liés à ce ProgID. Vous pouvez également utiliser l’entrée EditFlags pour limiter la quantité d’utilisateurs pouvant modifier certains aspects de ces types de fichiers à l’aide de la feuille de propriétés d’un fichier. Les valeurs FILETYPEATTRIBUTEFLAGS utilisées pour EditFlags sont des valeurs binaires conçues pour que vous puissiez combiner plusieurs attributs en une seule valeur dans une opération OR au niveau du bit. Il s’agit d’une valeur REG_DWORD ou REG_BINARY. |
| FriendlyTypeName | Définissez cette entrée sur un nom convivial pour le ProgID, adapté à l’affichage de l’utilisateur. Pour une cohérence, cette chaîne doit contenir les mêmes données que l’entrée par défaut pour cette clé ProgID. Cette entrée peut être une chaîne REG_SZ ou REG_EXPAND_SZ, mais elle doit être mise en forme en tant que chaîne indirecte (nom de fichier complet et valeur de ressource précédée du symbole @), par exemple @%SystemRoot%\shell32.dll,-154. |
| info-bulle | Définissez cette entrée sur un bref message d’aide que l’interpréteur de commandes affiche pour ce ProgID. L’entrée Info-bulle s’affiche dans une boîte de dialogue de souris. Cette valeur peut être une chaîne REG_SZ ou REG_EXPAND_SZ, mais, comme FriendlyTypeName, elle doit être mise en forme en tant que chaîne indirecte. |
| CurVer | Définissez l’entrée (par défaut) de cette sous-clé sur la version la plus récente de ce ProgID. Remarque : Sauf si vous avez des versions d’application côte à côte, c’est-à-dire plusieurs versions installées sur le même système, vous devez éviter d’utiliser CurVer. |
| DefaultIcon. | Définissez l’entrée (par défaut) de cette sous-clé sur l’icône par défaut que vous souhaitez afficher pour les types de fichiers associés à ce ProgID. Cette valeur peut être une chaîne REG_SZ ou REG_EXPAND_SZ, mais elle doit être fournie en tant que nom de fichier complet avec sa valeur de ressource standard, par exemple %SystemRoot%\shell32.dll,-154. |
L’exemple de clé de Registre suivant illustre un nœud de clé ProgID d’association de fichiers :
HKEY_CLASSES_ROOT
Vendor.App.1
(Default) = My Friendly Name
AllowSilentDefaultTakeOver
AppUserModelID = Vendor.Application
EditFlags = 0x00000001
FriendlyTypeName = @%SystemRoot%\shell32.dll,-154
InfoTip = @%SystemRoot%\shell32.dll,-54
CurVer
(Default) = Vendor.App.1
DefaultIcon
(Default) = %SystemRoot%\shell32.dll,-1
Utilisation d’identificateurs programmatiques avec version
Un ProgID versionné est un dont la version est indiquée dans son nom. Vous effectuez généralement cette opération en ajoutant un point et le numéro de version au nom. Par exemple:
- Word.Document.6
- Word.Document.8
Il s’agit respectivement de ProgID versionnés, avec les versions 6 et 8. Si vous avez une application côte à côte, c’est-à-dire une application qui prend en charge plusieurs versions de votre application installées en même temps, utilisez CurVer et Version Independent ProgIDs. Dans le cas contraire, CurVer et Version Independent ProgIDs doivent être évités, car ils entraînent une inefficacité.
Rubriques connexes