Extension (dans le type : CT_ApplicationExtensions)

Déclare un point d’extensibilité pour l’application.

Hiérarchie d’éléments

<Packages>
<Applications>
<Application>
<Extensions>
<Poste>

Syntaxe

<Extension Category     = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
           Executable?  = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
           EntryPoint?  = A string between 1 and 256 characters in length, representing the task  handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type.
If EntryPoint is not specified, the EntryPoint defined for the app is used instead.

           RuntimeType? = A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, %, ", /, \, |, ?, or *.
           StartPage?   = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( FileTypeAssociation
  | Protocol
  | AutoPlayContent
  | AutoPlayDevice
  | ShareTarget
  | FileOpenPicker
  | FileSavePicker
  | BackgroundTasks
  )?

</Extension>

Clé

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
Catégorie

Type du point d’extensibilité de l’application.

Cet attribut peut avoir l’une des valeurs suivantes :

  • Windows. fileTypeAssociation
  • Windows. Protocole
  • Windows. autoPlayContent
  • Windows. autoPlayDevice
  • Windows. shareTarget
  • Windows. Search
  • Windows. fileOpenPicker
  • Windows. fileSavePicker
  • Windows. cachedFileUpdater
  • Windows. contactPicker
  • Windows. backgroundTasks
  • Windows. cameraSettings
  • Windows. accountPictureProvider
  • Windows. printTaskSettings
Oui
EntryPoint

ID de classe activable.

Chaîne d’une longueur comprise entre 1 et 256 caractères représentant la tâche qui gère l’extension. Il s’agit généralement du nom complet de l’espace de noms d’un type Windows Runtime. Si EntryPoint n’est pas spécifié, le point d’entrée défini pour l’application est utilisé à la place. No
Exécutable

Exécutable de lancement par défaut.

Chaîne contenant entre 1 et 256 caractères qui doivent se terminer par « .exe » et ne peuvent pas contenir les caractères suivants : < , > , :,%, ", |, ? ou *. Il spécifie l’exécutable par défaut pour l’extension. S’il n’est pas spécifié, l’exécutable défini pour l’application est utilisé. S’il est spécifié, la propriété EntryPoint est également utilisée. Si cette propriété EntryPoint n’est pas spécifiée, le point d’entrée défini pour l’application est utilisé. No
RuntimeType

Fournisseur du Runtime. Cet attribut est utilisé en général lorsqu’il existe des infrastructures mixtes dans une application.

Chaîne comportant entre 1 et 255 caractères qui ne peuvent pas commencer ou se terminer par un point ou qui contiennent les caractères suivants : < , > , :,%, ",/, \, |, ? ou *. No
StartPage

La page web qui gère le point d’extensibilité.

Chaîne de longueur comprise entre 1 et 256 caractères qui ne peuvent pas contenir les caractères suivants : < , > , :,%, ", |, ? ou *. No

 

Éléments enfants

Élément enfant Description
AutoPlayContent

Déclare un point d’extensibilité de l’application de type Windows. autoPlayContent. L’application fournit les actions de contenu de lecture automatique spécifiées.

AutoPlayDevice

Déclare un point d’extensibilité de l’application de type Windows. autoPlayDevice. L’application fournit les actions d’appareil de lecture automatique spécifiées.

BackgroundTasks

Définit un point d’extensibilité de l’application de type Windows. backgroundTasks. Les tâches en arrière-plan s’exécutent dans un hôte d’arrière-plan dédié. autrement dit, sans interface utilisateur.

FileOpenPicker

Déclare un point d’extensibilité de l’application de type Windows. fileOpenPicker. L’application permet à l’utilisateur de choisir et d’ouvrir les types de fichiers spécifiés.

FileSavePicker

Déclare un point d’extensibilité de l’application de type Windows. fileSavePicker. L’application permet à l’utilisateur de choisir le nom de fichier, l’extension et l’emplacement de stockage pour les types de fichiers spécifiés.

FileTypeAssociation

Déclare un point d’extensibilité de l’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.

Protocole

Déclare un point d’extensibilité de l’application de type Windows. Protocol. Une association d’URI indique que l’application est inscrite pour gérer les URI avec le schéma spécifié.

ShareTarget

Déclare un point d’extension d’application de type Windows. shareTarget. L’application peut partager les types de fichiers spécifiés.

 

Éléments parents

Élément parent Description
Extensions (type : CT_ApplicationExtensions)

Définit un ou plusieurs points d’extensibilité pour l’application.

 

Les éléments suivants portent le même nom que celui-ci, mais ils ont un contenu ou des attributs différents :

Notes

Ces points d’extensibilité ne peuvent être déclarés qu’une seule fois par application :

  • Windows. accountPictureProvider
  • Windows. cachedFileUpdater
  • Windows. cameraSettings
  • Windows. contactPicker
  • Windows. fileOpenPicker
  • Windows. fileSavePicker
  • Windows. printTaskSettings
  • Windows. Search
  • Windows. shareTarget

* * Remarque à propos des règles sémantiques pour les extensions : * * pour tous les éléments d’extension, les règles sémantiques suivantes sont appliquées dans l’API du manifeste :

si/Application/@StartPage spécifié, il s’agit d’une application Windows à l’aide de JavaScript et de l’Extension d’application :

  • Peut être vide
  • Peut spécifier uniquement la StartPage
  • Peut spécifier à la fois un exécutable et un point d’entrée (RuntimeType facultatif autorisé), sauf s’il s’agit d’une extension BackgroundTask, auquel cas il peut omettre l’exécutable et la valeur par défaut pour le BackgroundTaskHost.exe exécutable.

si/Application/@StartPage n’est pas spécifié, il s’agit d’une application UWP utilisant C# ou VB et XAML, ainsi que l’Extension de l’application :

  • Peut être vide
  • Peut spécifier uniquement la StartPage
  • Le point d’entrée doit être spécifié si Executable ou RuntimeType est spécifié.

Exemples

L’exemple suivant est extrait du manifeste de package de l’un des exemples du kit de développement logiciel (SDK).

<Applications>
  <Application Id="App" StartPage="default.html">
    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>
    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>
      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

Voir aussi

Conceptset extensions de l’application concepts

Spécifications

Valeur
Espace de noms http://schemas.microsoft.com/appx/2010/manifest