uap :FileTypeAssociation (Windows 10)

Article
10/30/2023

Déclare un point d’extensibilité d’application de type windows.fileTypeAssociation. Une association de type de fichier indique que l’application est inscrite pour gérer les fichiers des types spécifiés.

Hiérarchie d’éléments

<uap:Extension>

<uap:FileTypeAssociation>

Syntax

<uap:FileTypeAssociation
  Name = 'A string with a value between 1 and 100 characters in length.'
  DesiredView = 'An optional string that can have one of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".'
  desktop2:UseUrl = 'An optional boolean value.'
  desktop2:AllowSilentDefaultTakeOver = 'An optional boolean value.' 
  desktop5:ThumbnailTypeOverlay = 'A string with a value between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.' >

  <!-- Child elements -->
  uap:DisplayName?
  & uap:Logo?
  & uap:InfoTip?
  & uap:EditFlags?
  & uap:SupportedFileTypes?
  & uap2:SupportedVerbs?
  & uap4:KindMap?
  & rescap3:MigrationProgIds?
  & desktop2:ThumbnailHandler?
  & desktop2:OleClass?
  & desktop2:DesktopPreviewHandler?
  & desktop2:DesktopPropertyHandler?
  & desktop3:PropertyLists?
  & desktop7:Logo?
  & desktop7:ProgId?
  & desktop10:IconHandler?

</uap:FileTypeAssociation>

Clé :

? connecteur facultatif (zéro ou un) & entrelacement (peut se produire dans n’importe quel ordre)

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
Nom	Nom de l’association de types de fichiers. Vous pouvez utiliser ce nom pour organiser et regrouper des types de fichiers. Le nom doit contenir uniquement des minuscules, sans espace.	Chaîne dont la valeur est comprise entre 1 et 100 caractères.	Yes
DesiredView	Quantité d’espace d’écran souhaitée à utiliser au lancement de l’application. Cette préférence de mode d’affichage est une valeur demandée uniquement. La taille préférée que vous spécifiez n’est pas garantie d’être respectée par Windows. Par conséquent, vous ne devez pas écrire de code qui repose sur le fait de ne jamais atteindre une taille inférieure à la taille minimale préférée ou supérieure à la taille maximale préférée.	Chaîne facultative qui peut avoir l’une des valeurs suivantes : default, useLess, useHalf, useMore ou useMinimum.	No
desktop2 :UseUrl	Si la valeur est true, spécifie que l’application peut accepter une URL, au lieu d’un nom de fichier, sur la ligne de commande. Les applications qui peuvent ouvrir des documents directement à partir d’Internet, telles que les navigateurs web et les lecteurs multimédias, doivent utiliser cette valeur. Lorsque `ShellExecuteEx` démarre une application et que cette valeur est définie sur false, le comportement par défaut télécharge `ShellExecuteEx` le document dans un fichier local et appelle le gestionnaire sur la copie locale.	Valeur booléenne facultative.	No
desktop2 :AllowSilentDefaultTakeOver	Si la valeur est true, l’application apparaît dans une liste « Ouvrir avec », mais elle ne sera pas l’application par défaut pour le type de fichier.	Valeur booléenne facultative.	No
desktop5 :ThumbnailTypeOverlay	Ressource d’image pour une superposition de miniatures.	Chaîne dont la longueur est comprise entre 1 et 256 caractères et qui se termine par , ou qui ne peut pas contenir ces caractères : `<`, `>`, `":`, `\|`, `?`, ou `*`.`.jpeg.png.jpg` Dans cette chaîne, les `/` caractères et `\` ne peuvent pas être le premier ou le dernier caractères. En outre, la chaîne peut contenir `/` ou mais `\` pas les deux.	No

Éléments enfants

Élément enfant	Description
uap:DisplayName	Nom convivial qui peut être affiché aux utilisateurs.
uap:EditFlags	Spécifie le type d’informations que l’utilisateur voit lors de l’ouverture d’un fichier associé au point d’extensibilité.
uap:InfoTip	Définit une chaîne qui fournit des informations supplémentaires à l’utilisateur sur le type de fichier.
uap:Logo	Chemin d’accès à un fichier qui contient une image.
uap :SupportedFileTypes (type : CT_FTASupportedFileTypes)	Définit les types de fichiers associés à l’application. Ils sont uniques par package et respectent la casse.
uap2:SupportedVerbs	Contient des verbes pour un menu contextuel de fichier.
uap4:KindMap	Spécifie ce qu’est Kind et comment il est utilisé.
rescap3:MigrationProgIds	Contient des valeurs d’identificateur programmatique (ProgID) qui décrivent l’application, le composant et la version de chaque application de bureau dont vous souhaitez hériter des associations de fichiers.
desktop2:ThumbnailHandler	Active un ThumbnailProvider pour une association de type de fichier.
desktop2:OleClass	Permet à OLE d’obtenir la classe OLE inscrite pour une extension de fichier donnée.
desktop2:DesktopPreviewHandler	Active la déclaration d’un gestionnaire d’aperçu pour une association de type de fichier.
desktop2:DesktopPropertyHandler	Active la déclaration d’un gestionnaire de propriétés pour une association de type de fichier.
desktop3 :PropertyLists	Contient une liste de propriétés à afficher sous l’onglet propriétés d’un fichier.
desktop7 :Logo	Chemin d’accès à un fichier qui contient une image. Ajoute la prise en charge des extensions de fichier .ico.
desktop7 :ProgId	Identificateur programmatique (ProgID) qui peut être associé à un CLSID.
desktop10 :IconHandler	Active un IconHandler pour une association de type de fichier.

Éléments parents

Élément parent	Description
uap:Extension	Déclare un point d’extensibilité pour l’application.

Configuration requise

Élément	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
Minimum OS Version	Windows 10 version 1511 (build 10586)