Dela via

Integrera din skrivbordsapp med Windows med hjälp av paketeringstillägg

Om din skrivbordsapp är paketerad (har paketidentitet vid körning) kan du använda tillägg för att integrera din app med Windows med hjälp av fördefinierade tillägg i paketmanifestet. Se även funktioner som kräver paketidentitet.

Använd till exempel ett tillägg för att skapa ett brandväggsundantag; gör din app till standardprogram för en filtyp; eller peka Start-rutor till din app. Om du vill använda ett tillägg lägger du bara till lite XML i appens paketmanifestfil. Ingen kod krävs.

Det här avsnittet beskriver dessa tillägg och de uppgifter som du kan utföra med hjälp av dem.

Obs

Funktionerna som beskrivs i det här avsnittet kräver att din app är paketerad (har paketidentitet vid körning). Det inkluderar paketerade appar (se Skapa ett nytt projekt för en paketerad WinUI 3-skrivbordsapp) och paketerade appar med extern plats (se Bevilja paketidentitet genom att paketera med extern plats). Se även funktioner som kräver paketidentitet.

Överföra användare till din app

Hjälp användarna att övergå till din paketerade app.

Omdirigera din befintliga skrivbordsapp till din paketerade app

När användarna startar din befintliga uppackade skrivbordsapp kan du konfigurera din paketerade app så att den öppnas istället.

Obs

Den här funktionen stöds i Windows Insider Preview Build 21313 och senare versioner.

Så här aktiverar du det här beteendet:

  1. Lägg till registerposter för att omdirigera den uppackade skrivbordsappen som kan köras till din paketerade app.
  2. Registrera din paketerade app för att startas när den opaketerade skrivbordsappens körbara fil startas.

Lägg till registerposter för att omdirigera den opacketerade körbara skrivbordsappen

  1. I registret skapar du en undernyckel med namnet på den körbara filen för skrivbordsappen under den HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options nyckeln.
  2. Under den här undernyckeln lägger du till följande värden:
    • AppExecutionAliasRedirect (DWORD): Om värdet är 1 söker systemet efter ett AppExecutionAlias pakettillägg med samma namn som den körbara filen. Om AppExecutionAlias-tillägget är aktiverat aktiveras den paketerade appen med det värdet.
    • AppExecutionAliasRedirectPackages (REG_SZ): Systemet omdirigeras endast till de listade paketen. Paket listas med deras paketfamiljenamn, avgränsade med semikolon. Om specialvärdet * används omdirigeras systemet till en AppExecutionAlias från ett paket.

Till exempel:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\contosoapp.exe 
    AppExecutionAliasRedirect = 1
    AppExecutionAliasRedirectPackages = "Microsoft.WindowsNotepad_8weky8webbe"

Registrera din paketerade app som ska startas

I ditt paketmanifest lägger du till ett AppExecutionAlias-tillägg som registrerar namnet på den icke-förpackade skrivbordsappens körbara fil. Till exempel:

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap3:Extension Category="windows.appExecutionAlias" EntryPoint="Windows.FullTrustApplication">
          <uap3:AppExecutionAlias>
            <desktop:ExecutionAlias Alias="contosoapp.exe" />
          </uap3:AppExecutionAlias>
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Inaktivera omdirigeringen

Användarna kan inaktivera omdirigeringen och starta den uppackade appens körbara fil via följande alternativ:

  • De kan avinstallera den paketerade versionen av din app.
  • Användaren kan inaktivera posten AppExecutionAlias för din paketerade app på sidan App-körningsalias i Inställningar.

XML-namnområden

  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10

Element och attribut i det här tillägget

<uap3:Extension
    Category="windows.appExecutionAlias"
    EntryPoint="Windows.FullTrustApplication">
    <uap3:AppExecutionAlias>
        <desktop:ExecutionAlias Alias="[AliasName]" />
    </uap3:AppExecutionAlias>
</uap3:Extension>
Namn Beskrivning
Kategori Alltid windows.appExecutionAlias.
Genomförbar Den relativa sökvägen till den körbara filen som ska startas när aliaset anropas.
Tillnamn Det korta namnet på din app. Det måste alltid sluta med tillägget ".exe".

Peka befintliga startpaneler och knappar i aktivitetsfältet till din paketerade app

Användarna kan ha fäst skrivbordsprogrammet i aktivitetsfältet eller på Start-menyn. Du kan peka dessa genvägar till din nya paketerade app.

XML-namnområde

http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

Element och attribut i det här tillägget

<Extension Category="windows.desktopAppMigration">
    <DesktopAppMigration>
        <DesktopApp AumId="[your_app_aumid]" />
        <DesktopApp ShortcutPath="[path]" />
    </DesktopAppMigration>
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.desktopAppMigration.
AumID Programanvändarmodell-ID för din paketerade app.
Genväg Sökväg Sökvägen till .lnk-filer som startar skrivbordsversionen av din app.

Exempel

<Package
  xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="rescap3">
  <Applications>
    <Application>
      <Extensions>
        <rescap3:Extension Category="windows.desktopAppMigration">
          <rescap3:DesktopAppMigration>
            <rescap3:DesktopApp AumId="[your_app_aumid]" />
            <rescap3:DesktopApp ShortcutPath="%USERPROFILE%\Desktop\[my_app].lnk" />
            <rescap3:DesktopApp ShortcutPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\[my_app].lnk" />
            <rescap3:DesktopApp ShortcutPath="%PROGRAMDATA%\Microsoft\Windows\Start Menu\Programs\[my_app_folder]\[my_app].lnk"/>
         </rescap3:DesktopAppMigration>
        </rescap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

WPF-bildvisningsprogram med övergång/migrering/avinstallation

Gör ditt paketerade program öppna filer istället för att din skrivbordsapp öppnar dem

Du kan se till att användarna öppnar det nya paketerade programmet som standard för specifika typer av filer i stället för att öppna skrivbordsversionen av appen.

För att göra det anger du programmatisk identifierare (ProgID) för varje program som du vill ärva filassociationer från.

XML-namnområden

  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

Element och attribut i det här tillägget

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
         <MigrationProgIds>
            <MigrationProgId>"[ProgID]"</MigrationProgId>
        </MigrationProgIds>
    </FileTypeAssociation>
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.fileTypeAssociation.
Namn Namnet på filtypsassociationen. Du kan använda det här namnet för att ordna och gruppera filtyper. Namnet måste vara alla gemener utan blanksteg.
MigrationProgId (på engelska) Den programmatiska identifieraren (ProgID) som beskriver programmet, komponenten och versionen av skrivbordsprogrammet som du vill ärva filassociationer från.

Exempel

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="uap3, rescap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <rescap3:MigrationProgIds>
              <rescap3:MigrationProgId>Foo.Bar.1</rescap3:MigrationProgId>
              <rescap3:MigrationProgId>Foo.Bar.2</rescap3:MigrationProgId>
            </rescap3:MigrationProgIds>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

WPF-bildvisningsprogram med övergång/migrering/avinstallation

Associera ditt paketerade program med en uppsättning filtyper

Du kan associera ditt paketerade program med filtypstillägg. Om en användare högerklickar på en fil i Utforskaren och sedan väljer alternativet Öppna med visas ditt program i listan med förslag. Mer information om hur du använder det här tillägget finns i Integrera en paketerad skrivbordsapp med Utforskaren.

XML-namnområden

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Element och attribut i det här tillägget

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[file extension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.fileTypeAssociation.
Namn Namnet på filtypsassociationen. Du kan använda det här namnet för att ordna och gruppera filtyper. Namnet måste vara alla gemener utan blanksteg.
Filtyp Filtillägget som stöds av din app.

Exempel

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="mediafiles">
            <uap:SupportedFileTypes>
            <uap:FileType>.avi</uap:FileType>
            </uap:SupportedFileTypes>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

WPF-bildvisningsprogram med övergång/migrering/avinstallation

Lägg till alternativ i snabbmenyerna med filer som har en viss filtyp

Med det här tillägget kan du lägga till alternativ på snabbmenyn som visas när användare högerklickar på en fil i Utforskaren. Dessa alternativ ger användarna andra sätt att interagera med filen, till exempel skriva ut, redigera eller förhandsgranska filen. Mer information om hur du använder det här tillägget finns i Integrera en paketerad skrivbordsapp med Utforskaren.

XML-namnområden

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/2
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Element och attribut i det här tillägget

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedVerbs>
           <Verb Id="[ID]" Extended="[Extended]" Parameters="[parameters]">"[verb label]"</Verb>
        </SupportedVerbs>
    </FileTypeAssociation>
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.fileTypeAssociation.
Namn Namnet på filtypsassociationen. Du kan använda det här namnet för att ordna och gruppera filtyper. Namnet måste vara alla gemener utan blanksteg.
Verb Namnet som visas i kontextmenyn i Utforskaren. Den här strängen kan lokaliseras och använder ms-resource.
Id Verbets unika Id. Om ditt program är en UWP-app skickas detta till din app som en del av aktiveringshändelsen args så att den kan hantera användarens val på rätt sätt. Om ditt program är en paketerad app med fullständigt förtroende tar den emot parametrar i stället (se nästa punkt).
Parametrar Listan över argumentparametrar och värden som är associerade med verbet. Om ditt program är en paketerad app med fullständigt förtroende skickas dessa parametrar till programmet som händelse args när programmet aktiveras. Du kan anpassa programmets beteende baserat på olika aktiveringsverb. Om en variabel kan innehålla en filsökväg omsluter du parametervärdet med citattecken. Detta kommer att undvika eventuella problem som uppstår i fall där sökvägen innehåller mellanslag. Om ditt program är en UWP-app kan du inte skicka parametrar. Appen tar emot ID:t i stället (se föregående punkt).
Utökad Anger att verbet endast visas om användaren visar snabbmenyn genom att hålla i Skift- innan du högerklickar på filen. Det här attributet är valfritt och har ett standardvärde på False (till exempel att alltid visa verbet), om det inte anges. Du anger det här beteendet individuellt för varje verb (förutom "Öppna", vilket alltid är False).

Exempel

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"

  IgnorableNamespaces="uap, uap2, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap2:SupportedVerbs>
              <uap3:Verb Id="Edit" Parameters="/e &quot;%1&quot;">Edit</uap3:Verb>
              <uap3:Verb Id="Print" Extended="true" Parameters="/p &quot;%1&quot;">Print</uap3:Verb>
            </uap2:SupportedVerbs>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

WPF-bildvisningsprogram med övergång/migrering/avinstallation

Öppna vissa typer av filer direkt med hjälp av en URL

Du kan se till att användarna öppnar det nya paketerade programmet som standard för specifika typer av filer i stället för att öppna skrivbordsversionen av appen.

XML-namnområden

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Element och attribut i det här tillägget

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]" UseUrl="true" Parameters="%1">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.fileTypeAssociation.
Namn Namnet på filtypsassociationen. Du kan använda det här namnet för att ordna och gruppera filtyper. Namnet måste vara alla gemener utan blanksteg.
UseUrl (på engelska) Anger om filer ska öppnas direkt från ett URL-mål. Om du inte anger det här värdet gör programmets försök att öppna en fil med hjälp av en URL att systemet först laddar ned filen lokalt.
Parametrar Valfria parametrar.
Filtyp Relevanta filnamnstillägg.

Exempel

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap3">
  <Applications>
      <Application>
        <Extensions>
          <uap:Extension Category="windows.fileTypeAssociation">
            <uap3:FileTypeAssociation Name="myfiletypes" UseUrl="true" Parameters="%1">
              <uap:SupportedFileTypes>
                <uap:FileType>.txt</uap:FileType>
                <uap:FileType>.doc</uap:FileType>
              </uap:SupportedFileTypes>
            </uap3:FileTypeAssociation>
          </uap:Extension>
        </Extensions>
      </Application>
    </Applications>
</Package>

Utföra installationsaktiviteter

Skapa brandvägsundantag för din app

Om programmet kräver kommunikation via en port kan du lägga till ditt program i listan över brandväggsfel.

Obs

Om du vill använda tilläggskategorin "windows.firewallRules" (se nedan) behöver ditt paket fullständig behörighetsnivå för förtroende begränsad kapacitet. Se lista över begränsade funktioner.

XML-namnområde

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Element och attribut i det här tillägget

<Extension Category="windows.firewallRules">
  <FirewallRules Executable="[executable file name]">
    <Rule
      Direction="[Direction]"
      IPProtocol="[Protocol]"
      LocalPortMin="[LocalPortMin]"
      LocalPortMax="LocalPortMax"
      RemotePortMin="RemotePortMin"
      RemotePortMax="RemotePortMax"
      Profile="[Profile]"/>
  </FirewallRules>
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.firewallRules
Genomförbar Namnet på den körbara fil som du vill lägga till i listan över brandväggsundantag
Riktning Anger om regeln är en regel för inkommande eller utgående trafik
IP-protokoll Kommunikationsprotokollet
LokalPortMin Det lägre portnumret i ett intervall med lokala portnummer.
LocalPortMax (på engelska) Det högsta portnumret för ett intervall med lokala portnummer.
FjärrportMax Det lägre portnumret i ett intervall av portnummer för fjärranslutning.
FjärrportMax Det högsta portnumret för ett intervall med fjärranslutna portnummer.
Profil Nätverkstypen

Exempel

<Package
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="desktop2">
  <Extensions>
    <desktop2:Extension Category="windows.firewallRules">
      <desktop2:FirewallRules Executable="Contoso.exe">
          <desktop2:Rule Direction="in" IPProtocol="TCP" Profile="all"/>
          <desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="domain"/>
          <desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="public"/>
          <desktop2:Rule Direction="out" IPProtocol="UDP" LocalPortMin="1339" LocalPortMax="1340" RemotePortMin="15"
                         RemotePortMax="19" Profile="domainAndPrivate"/>
          <desktop2:Rule Direction="out" IPProtocol="GRE" Profile="private"/>
      </desktop2:FirewallRules>
  </desktop2:Extension>
</Extensions>
</Package>

Placera DLL-filerna i valfri mapp i paketet

Använd tillägget uap6:LoaderSearchPathOverride för att deklarera upp till fem mappsökvägar i apppaketet, i förhållande till apppaketets rotsökväg, som ska användas i inläsningssökvägen för appens processer.

DLL-sökordningen för Windows-appar innehåller paket i paketberoendediagrammet om paketen har körningsrättigheter. Som standard innehåller detta huvudpaket, valfria paket och ramverkspaket, även om detta kan skrivas över av uap6:AllowExecution-elementet i paketmanifestet.

Ett paket som ingår i DLL-sökordningen inkluderar som standard dess effektiva sökväg. Mer information om effektiva sökvägar finns i egenskapen EffectivePath (WinRT) och PackagePathType uppräkningen (Win32).

Om ett paket anger uap6:LoaderSearchPathOverrideanvänds den här informationen i stället för paketets effektiva sökväg.

Varje paket kan bara innehålla ett uap6:LoaderSearchPathOverride-tillägg. Det innebär att du kan lägga till en av dem i ditt huvudpaket och sedan lägga till en i vart och ett av dina valfria paket och relaterade uppsättningar.

XML-namnområde

http://schemas.microsoft.com/appx/manifest/uap/windows10/6

Element och attribut i det här tillägget

Deklarera det här tillägget på paketnivå för appmanifestet.

<Extension Category="windows.loaderSearchPathOverride">
  <LoaderSearchPathOverride>
    <LoaderSearchPathEntry FolderPath="[path]"/>
  </LoaderSearchPathOverride>
</Extension>
Namn Beskrivning
Kategori Alltid windows.loaderSearchPathOverride.
Mappsökväg Sökvägen till mappen som innehåller dina DLL-filer. Ange en sökväg som är relativ till rotmappen för paketet. Du kan ange upp till fem sökvägar i ett tillägg. Om du vill att systemet ska söka efter filer i rotmappen i paketet använder du en tom sträng för någon av dessa sökvägar. Inkludera inte duplicerade sökvägar och se till att sökvägarna inte innehåller inledande och avslutande snedstreck eller omvända snedstreck.

Systemet söker inte efter undermappar, så se till att uttryckligen lista varje mapp som innehåller DLL-filer som du vill att systemet ska läsa in.

Exempel

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/6"
  IgnorableNamespaces="uap6">
  ...
    <Extensions>
      <uap6:Extension Category="windows.loaderSearchPathOverride">
        <uap6:LoaderSearchPathOverride>
          <uap6:LoaderSearchPathEntry FolderPath=""/>
          <uap6:LoaderSearchPathEntry FolderPath="folder1/subfolder1"/>
          <uap6:LoaderSearchPathEntry FolderPath="folder2/subfolder2"/>
        </uap6:LoaderSearchPathOverride>
      </uap6:Extension>
    </Extensions>
...
</Package>

Integrera med Utforskaren

Hjälp användarna att organisera dina filer och interagera med dem på välbekanta sätt.

Definiera hur ditt program fungerar när användare väljer och öppnar flera filer samtidigt

Ange hur programmet fungerar när en användare öppnar flera filer samtidigt.

XML-namnområden

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/2
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Element och attribut i det här tillägget

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]" MultiSelectModel="[SelectionModel]">
        <SupportedVerbs>
            <Verb Id="Edit" MultiSelectModel="[SelectionModel]">Edit</Verb>
        </SupportedVerbs>
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.fileTypeAssociation.
Namn Namnet på filtypsassociationen. Du kan använda det här namnet för att ordna och gruppera filtyper. Namnet måste vara alla gemener utan blanksteg.
Flervalsmodell Se nedan
Filtyp Relevanta filnamnstillägg.

MultiSelectModell

paketerade skrivbordsappar har samma tre alternativ som vanliga skrivbordsappar.

  • Player: Programmet aktiveras en gång. Alla markerade filer skickas till ditt program som argumentparametrar.
  • Single: Programmet aktiveras en gång för den första valda filen. Andra filer ignoreras.
  • Document: En ny, separat instans av ditt program aktiveras för varje vald fil.

Du kan ange olika inställningar för olika filtyper och åtgärder. Du kanske till exempel vill öppna Dokument i dokument läge och Bilder i Player läge.

Exempel

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap2, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes" MultiSelectModel="Document">
            <uap2:SupportedVerbs>
              <uap3:Verb Id="Edit" MultiSelectModel="Player">Edit</uap3:Verb>
              <uap3:Verb Id="Preview" MultiSelectModel="Document">Preview</uap3:Verb>
            </uap2:SupportedVerbs>
            <uap:SupportedFileTypes>
              <uap:FileType>.txt</uap:FileType>
            </uap:SupportedFileTypes>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Om användaren öppnar 15 eller färre filer är standardvalet för attributet MultiSelectModelPlayer. Annars är standardvärdet Dokument. UWP-appar startas alltid som Player.

Visa filinnehåll i en miniatyrbild i Utforskaren

Gör det möjligt för användare att visa en miniatyrbild av filens innehåll när ikonen för filen visas i den medelstora, stora eller extra stora storleken.

XML-namnområde

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/2
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Element och attribut i det här tillägget

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <ThumbnailHandler
            Clsid  ="[Clsid  ]" />
    </FileTypeAssociation>
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.fileTypeAssociation.
Namn Namnet på filtypsassociationen. Du kan använda det här namnet för att ordna och gruppera filtyper. Namnet måste vara alla gemener utan blanksteg.
Filtyp Relevanta filnamnstillägg.
Clsid Clsid Klass-ID för din app.

Exempel

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap2, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
            </uap:SupportedFileTypes>
            <desktop2:ThumbnailHandler
              Clsid  ="20000000-0000-0000-0000-000000000001"  />
            </uap3:FileTypeAssociation>
         </uap::Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Visa filinnehåll i förhandsgranskningsfönstret i Utforskaren

Gör det möjligt för användare att förhandsgranska en fils innehåll i förhandsgranskningsfönstret i Utforskaren.

XML-namnområde

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/2
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Element och attribut i det här tillägget

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <DesktopPreviewHandler Clsid  ="[Clsid  ]" />
    </FileTypeAssociation>
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.fileTypeAssociation.
Namn Namnet på filtypsassociationen. Du kan använda det här namnet för att ordna och gruppera filtyper. Namnet måste vara alla gemener utan blanksteg.
Filtyp Relevanta filnamnstillägg.
Clsid Clsid Klass-ID för din app.

Exempel

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap2, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
                </uap:SupportedFileTypes>
              <desktop2:DesktopPreviewHandler Clsid ="20000000-0000-0000-0000-000000000001" />
           </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Gör det möjligt för användare att gruppera filer med hjälp av kolumnen Typ i Utforskaren

Du kan associera ett eller flera fördefinierade värden för dina filtyper med fältet Kind.

I Utforskaren kan användare gruppera dessa filer med hjälp av det fältet. Systemkomponenter använder också det här fältet i olika syften, till exempel indexering.

Mer information om fältet Typ och de värden som du kan använda för det här fältet finns i Använda typnamn.

XML-namnområden

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

Element och attribut i det här tillägget

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <KindMap>
            <Kind value="[KindValue]">
        </KindMap>
    </FileTypeAssociation>
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.fileTypeAssociation.
Namn Namnet på filtypsassociationen. Du kan använda det här namnet för att ordna och gruppera filtyper. Namnet måste vara alla gemener utan blanksteg.
Filtyp Relevanta filnamnstillägg.
värde Ett giltigt Kind-värde

Exempel

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="uap, rescap">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
           <uap:FileTypeAssociation Name="mediafiles">
             <uap:SupportedFileTypes>
               <uap:FileType>.m4a</uap:FileType>
               <uap:FileType>.mta</uap:FileType>
             </uap:SupportedFileTypes>
             <rescap:KindMap>
               <rescap:Kind value="Item">
               <rescap:Kind value="Communications">
               <rescap:Kind value="Task">
             </rescap:KindMap>
          </uap:FileTypeAssociation>
      </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Gör filegenskaper tillgängliga för sökning, index, egenskapsdialogrutor och informationsfönstret

XML-namnområde

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Element och attribut i det här tillägget

<uap:Extension Category="windows.fileTypeAssociation">
    <uap:FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>.bar</FileType>
        </SupportedFileTypes>
        <DesktopPropertyHandler Clsid ="[Clsid]"/>
    </uap:FileTypeAssociation>
</uap:Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.fileTypeAssociation.
Namn Namnet på filtypsassociationen. Du kan använda det här namnet för att ordna och gruppera filtyper. Namnet måste vara alla gemener utan blanksteg.
Filtyp Relevanta filnamnstillägg.
Clsid Clsid Klass-ID för din app.

Exempel

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
            </uap:SupportedFileTypes>
            <desktop2:DesktopPropertyHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Ange en snabbmenyhanterare för en filtyp

Om ditt skrivbordsprogram definierar en snabbmenyhanterareanvänder du det här tillägget för att registrera menyhanteraren.

XML-namnområden

  • http://schemas.microsoft.com/appx/manifest/foundation/windows10
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10/4

Element och attribut i det här tillägget

<Extensions>
    <com:Extension Category="windows.comServer">
        <com:ComServer>
            <com:SurrogateServer AppId="[AppID]" DisplayName="[DisplayName]">
                <com:Class Id="[Clsid]" Path="[Path]" ThreadingModel="[Model]"/>
            </com:SurrogateServer>
        </com:ComServer>
    </com:Extension>
    <desktop4:Extension Category="windows.fileExplorerContextMenus">
        <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type="[Type]">
                <desktop4:Verb Id="[ID]" Clsid="[Clsid]" />
            </desktop4:ItemType>
        </desktop4:FileExplorerContextMenus>
    </desktop4:Extension>
</Extensions>

Hitta den fullständiga schemareferensen här: com:ComServer och desktop4:FileExplorerContextMenus.

Instruktioner

Följ dessa instruktioner för att registrera snabbmenyhanteraren.

  1. I ditt skrivbordsprogram implementerar du en snabbmenyhanterare genom att implementera gränssnittet IExplorerCommand eller IExplorerCommandState. Ett exempel finns i kodexemplet ExplorerCommandVerb. Se till att du definierar ett klass-GUID för vart och ett av dina implementeringsobjekt. Följande kod definierar till exempel ett klass-ID för en implementering av IExplorerCommand.

    class __declspec(uuid("00001111-aaaa-2222-bbbb-3333cccc4444")) CExplorerCommandVerb;

  2. I paketmanifestet anger du ett com:ComServer programtillägg som registrerar en COM-surrogatserver med klass-ID:t för implementeringen av snabbmenyhanteraren.

    <com:Extension Category="windows.comServer">
    <com:ComServer>
        <com:SurrogateServer AppId="00001111-aaaa-2222-bbbb-3333cccc4444" DisplayName="ContosoHandler">
            <com:Class Id="00001111-aaaa-2222-bbbb-3333cccc4444" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
        </com:SurrogateServer>
    </com:ComServer>
</com:Extension>

  3. I paketmanifestet anger du en desktop4:FileExplorerContextMenus programtillägg som registrerar implementeringen av snabbmenyhanteraren.

    <desktop4:Extension Category="windows.fileExplorerContextMenus">
    <desktop4:FileExplorerContextMenus>
        <desktop4:ItemType Type=".rar">
            <desktop4:Verb Id="Command1" Clsid="00001111-aaaa-2222-bbbb-3333cccc4444" />
        </desktop4:ItemType>
    </desktop4:FileExplorerContextMenus>
</desktop4:Extension>

Exempel

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:desktop4="http://schemas.microsoft.com/appx/manifest/desktop/windows10/4"
  xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
  IgnorableNamespaces="desktop4">
  <Applications>
    <Application>
      <Extensions>
        <com:Extension Category="windows.comServer">
          <com:ComServer>
            <com:SurrogateServer AppId="00001111-aaaa-2222-bbbb-3333cccc4444" DisplayName="ContosoHandler">
              <com:Class Id="00001111-aaaa-2222-bbbb-3333cccc4444" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
            </com:SurrogateServer>
          </com:ComServer>
        </com:Extension>
        <desktop4:Extension Category="windows.fileExplorerContextMenus">
          <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type=".contoso">
              <desktop4:Verb Id="Command1" Clsid="00001111-aaaa-2222-bbbb-3333cccc4444" />
            </desktop4:ItemType>
          </desktop4:FileExplorerContextMenus>
        </desktop4:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Gör så att filer från molntjänsten visas i Utforskaren

Registrera de hanterare som du implementerar i ditt program. Du kan också lägga till snabbmenyalternativ som visas när användarna högerklickar på dina molnbaserade filer i Utforskaren.

XML-namnområde

  • http://schemas.microsoft.com/appx/manifest/desktop/windows10

Element och attribut i det här tillägget

<Extension Category="windows.cloudfiles" >
    <CloudFiles IconResource="[Icon]">
        <CustomStateHandler Clsid ="[Clsid]"/>
        <ThumbnailProviderHandler Clsid ="[Clsid]"/>
        <ExtendedPropertyhandler Clsid ="[Clsid]"/>
        <CloudFilesContextMenus>
            <Verb Id ="Command3" Clsid= "[GUID]">[Verb Label]</Verb>
        </CloudFilesContextMenus>
    </CloudFiles>
</Extension>
Namn Beskrivning
Kategori Alltid windows.cloudfiles.
ikonresurs Ikonen som representerar molnfilprovidertjänsten. Den här ikonen visas i navigeringsfönstret i Utforskaren. Användarna väljer den här ikonen för att visa filer från molntjänsten.
CustomStateHandler Clsid Klass-ID för programmet som implementerar CustomStateHandler. Systemet använder det här klass-ID:t för att begära anpassade tillstånd och kolumner för molnfiler.
ThumbnailProviderHandler Clsid Klass-ID för programmet som implementerar ThumbnailProviderHandler. Systemet använder det här klass-ID:t för att begära miniatyrbilder för molnfiler.
UtökadEgenskapsHandler Clsid Klass-ID för programmet som implementerar ExtendedPropertyHandler. Systemet använder det här klass-ID:t för att begära utökade egenskaper för en molnfil.
Verb Namnet som visas på snabbmenyn i Utforskaren för filer som tillhandahålls av molntjänsten.
Id Verbets unika ID.

Exempel

<Package
    xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
    IgnorableNamespaces="desktop">
  <Applications>
    <Application>
      <Extensions>
        <Extension Category="windows.cloudfiles" >
            <CloudFiles IconResource="images\Wide310x150Logo.png">
                <CustomStateHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <ThumbnailProviderHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <ExtendedPropertyhandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <desktop:CloudFilesContextMenus>
                    <desktop:Verb Id ="keep" Clsid=
                       "20000000-0000-0000-0000-000000000001">
                       Always keep on this device</desktop:Verb>
                </desktop:CloudFilesContextMenus>
            </CloudFiles>
          </Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Starta programmet på olika sätt

Starta programmet med hjälp av ett protokoll

Protokollassociationer kan göra det möjligt för andra program och systemkomponenter att samverka med din paketerade app. När ditt paketerade program startas med hjälp av ett protokoll kan du ange specifika parametrar som ska skickas till dess aktiveringshändelseargument så att det kan bete sig därefter. Parametrar stöds endast för paketerade appar med fullständigt förtroende. UWP-appar kan inte använda parametrar.

XML-namnområde

http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Element och attribut i det här tillägget

<Extension
    Category="windows.protocol">
  <Protocol
      Name="[Protocol name]"
      Parameters="[Parameters]" />
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.protocol.
Namn Namnet på protokollet.
Parametrar Listan över parametrar och värden som ska skickas till ditt program som händelseargument när programmet aktiveras. Om en variabel kan innehålla en filsökväg omsluter du parametervärdet med citattecken. Detta kommer att undvika eventuella problem som uppstår i fall där sökvägen innehåller mellanslag.

Exempel

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="uap3, desktop">
  <Applications>
    <Application>
      <Extensions>
        <uap3:Extension
          Category="windows.protocol">
          <uap3:Protocol
            Name="myapp-cmd"
            Parameters="/p &quot;%1&quot;" />
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Starta ditt program med hjälp av ett alias

Användare och andra processer kan använda ett alias för att starta ditt program utan att behöva ange den fullständiga sökvägen till din app. Du kan ange det aliasnamnet.

XML-namnområden

  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10

Element och attribut i det här tillägget

<uap3:Extension
    Category="windows.appExecutionAlias"
    Executable="[ExecutableName]"
    EntryPoint="Windows.FullTrustApplication">
    <uap3:AppExecutionAlias>
        <desktop:ExecutionAlias Alias="[AliasName]" />
    </uap3:AppExecutionAlias>
</uap3:Extension>
Namn Beskrivning
Kategori Alltid windows.appExecutionAlias.
Genomförbar Den relativa sökvägen till den körbara filen som ska startas när aliaset anropas.
Tillnamn Det korta namnet på din app. Det måste alltid sluta med tillägget ".exe". Du kan bara ange ett enda appkörningsalias för varje program i paketet. Om flera appar registreras för samma alias anropar systemet den senaste som registrerades, så se till att välja ett unikt alias som andra appar sannolikt inte kommer att åsidosätta.

Exempel

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap3">
  <Applications>
    <Application>
      <Extensions>
         <uap3:Extension
                Category="windows.appExecutionAlias"
                Executable="exes\launcher.exe"
                EntryPoint="Windows.FullTrustApplication">
            <uap3:AppExecutionAlias>
                <desktop:ExecutionAlias Alias="Contoso.exe" />
            </uap3:AppExecutionAlias>
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Hitta den fullständiga schemareferensen här.

Starta en körbar fil när användare loggar in på Windows

Med startuppgifter kan din applikation köra en körbar fil automatiskt när en användare loggar in.

Obs

Användaren måste starta programmet minst en gång för att registrera den här startuppgiften.

Programmet kan deklarera flera startuppgifter. Varje aktivitet startar oberoende av varandra. Alla startuppgifter visas i Aktivitetshanteraren under fliken Start med det namn som du anger i appens manifest och appens ikon. Aktivitetshanteraren analyserar automatiskt starteffekten för dina uppgifter.

Användare kan inaktivera appens startuppgift manuellt med hjälp av Aktivitetshanteraren. Om en användare inaktiverar en uppgift kan du inte programmässigt återaktivera den.

XML-namnområde

http://schemas.microsoft.com/appx/manifest/desktop/windows10

Element och attribut i det här tillägget

<Extension
    Category="windows.startupTask"
    Executable="[ExecutableName]"
    EntryPoint="Windows.FullTrustApplication">
  <StartupTask
      TaskId="[TaskID]"
      Enabled="true"
      DisplayName="[DisplayName]" />
</Extension>
Namn Beskrivning
Kategori Alltid windows.startupTask.
Genomförbar Den relativa sökvägen till den körbara filen som ska startas.
UppgiftsID En unik identifierare för din uppgift. Med den här identifieraren kan ditt program anropa API:erna i Windows.ApplicationModel.StartupTask-klass för att programmatiskt aktivera eller inaktivera en startaktivitet.
Aktiverat Anger om aktiviteten först startar aktiverad eller inaktiverad. Aktiverade uppgifter körs nästa gång användaren loggar in (såvida inte användaren inaktiverar det).
Visningsnamn Namnet på aktiviteten som visas i Aktivitetshanteraren. Du kan lokalisera strängen med hjälp av ms-resource.

Exempel

<Package
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="desktop">
  <Applications>
    <Application>
      <Extensions>
        <desktop:Extension
          Category="windows.startupTask"
          Executable="bin\MyStartupTask.exe"
          EntryPoint="Windows.FullTrustApplication">
        <desktop:StartupTask
          TaskId="MyStartupTask"
          Enabled="true"
          DisplayName="My App Service" />
        </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
 </Package>

Gör det möjligt för användare att starta programmet när de ansluter en enhet till sin dator

Autoplay kan presentera ditt program som ett alternativ när en användare ansluter en enhet till sin dator.

XML-namnområde

http://schemas.microsoft.com/appx/manifest/desktop/windows10/3

Element och attribut i det här tillägget

<Extension Category="windows.autoPlayHandler">
  <AutoPlayHandler>
    <InvokeAction ActionDisplayName="[action string]" ProviderDisplayName="[name of your app/service]">
      <Content ContentEvent="[Content event]" Verb="[any string]" DropTargetHandler="[Clsid]" />
      <Content ContentEvent="[Content event]" Verb="[any string]" Parameters="[Initialization parameter]"/>
      <Device DeviceEvent="[Device event]" HWEventHandler="[Clsid]" InitCmdLine="[Initialization parameter]"/>
    </InvokeAction>
  </AutoPlayHandler>
Namn Beskrivning
Kategori Alltid windows.autoPlayHandler.
Åtgärdsvisningsnamn En sträng som representerar den åtgärd som användarna kan vidta med en enhet som de ansluter till en dator (till exempel "Importera filer" eller "Spela upp video").
Leverantörsvisningsnamn En sträng som representerar ditt program eller din tjänst (till exempel "Contoso videospelare").
Innehållshändelse Namnet på en innehållshändelse som gör att användarna tillfrågas med din ActionDisplayName och ProviderDisplayName. En innehållshändelse utlöses när en volymenhet, till exempel ett kameraminneskort, en tumenhet eller en DVD, sätts in i datorn. Du hittar den fullständiga listan över dessa händelser här.
Verb Verbinställningen identifierar ett värde som skickas till ditt program för det valda alternativet. Du kan ange flera startåtgärder för en autoplay-händelse och använda verbinställningen för att avgöra vilket alternativ en användare har valt för din app. Du kan se vilket alternativ användaren har valt genom att kontrollera verbegenskapen för starthändelseargumenten som skickas till din app. Du kan använda valfritt värde för verbinställningen förutom öppna, som är reserverad.
DropTargetHandler (på engelska) Klass-ID:t för programmet som implementerar IDropTarget--gränssnittet. Filer från det flyttbara mediet skickas till metoden Drop för din IDropTarget- implementering.
Parametrar Du behöver inte implementera IDropTarget--gränssnittet för alla innehållshändelser. För någon av innehållshändelserna kan du ange kommandoradsparametrar i stället för att implementera IDropTarget--gränssnittet. För dessa händelser startar AutoPlay ditt program med hjälp av dessa kommandoradsparametrar. Du kan parsa dessa parametrar i appens initieringskod för att avgöra om den startades av AutoPlay och sedan ange din anpassade implementering.
DeviceEvent (på engelska) Namnet på en enhetshändelse som gör att användarna uppmanas med dina ActionDisplayName och ProviderDisplayName. En enhetshändelse utlöses när en enhet är ansluten till datorn. Enhetshändelser börjar med strängen WPD och du hittar dem i listan här.
HWEventHandler Klass-ID för programmet som implementerar IHWEventHandler--gränssnittet.
InitCmdLine Strängparametern som du vill skicka till Initialize-metoden i IHWEventHandler-gränssnittet.

Exempel

<Package
  xmlns:desktop3="http://schemas.microsoft.com/appx/manifest/desktop/windows10/3"
  IgnorableNamespaces="desktop3">
  <Applications>
    <Application>
      <Extensions>
        <desktop3:Extension Category="windows.autoPlayHandler">
          <desktop3:AutoPlayHandler>
            <desktop3:InvokeAction ActionDisplayName="Import my files" ProviderDisplayName="ms-resource:AutoPlayDisplayName">
              <desktop3:Content ContentEvent="ShowPicturesOnArrival" Verb="show" DropTargetHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8"/>
              <desktop3:Content ContentEvent="PlayVideoFilesOnArrival" Verb="play" Parameters="%1" />
              <desktop3:Device DeviceEvent="WPD\ImageSource" HWEventHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8" InitCmdLine="/autoplay"/>
            </desktop3:InvokeAction>
          </desktop3:AutoPlayHandler>
      </Extensions>
    </Application>
  </Applications>
</Package>

Starta om automatiskt efter att ha fått en uppdatering från Microsoft Store

Om programmet är öppet när användarna installerar en uppdatering av det stängs programmet.

Om du vill att programmet ska startas om när uppdateringen har slutförts anropar du funktionen RegisterApplicationRestart i varje process som du vill starta om.

Varje aktivt fönster i programmet får ett WM_QUERYENDSESSION meddelande. Nu kan programmet anropa funktionen RegisterApplicationRestart igen för att uppdatera kommandoraden om det behövs.

När varje aktivt fönster i ditt program tar emot meddelandet WM_ENDSESSION bör programmet spara data och stängas av.

Obs

Dina aktiva fönster får också meddelandet WM_CLOSE om programmet inte hanterar WM_ENDSESSION meddelande.

Nu har programmet 30 sekunder på sig att stänga sina egna processer eller så avslutar plattformen dem med kraft.

När uppdateringen är klar startas programmet om.

Arbeta med andra program

Integrera med andra appar, starta andra processer eller dela information.

Gör så att ditt program visas som utskriftsmål i program som stöder utskrift

När användare vill skriva ut data från ett annat program, till exempel Anteckningar, kan du få ditt program att visas som ett utskriftsmål i appens lista över tillgängliga utskriftsmål.

Du måste ändra programmet så att det tar emot utskriftsdata i FORMATET XML Paper Specification (XPS).

XML-namnområden

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Element och attribut i det här tillägget

<Extension Category="windows.appPrinter">
    <AppPrinter
        DisplayName="[DisplayName]"
        Parameters="[Parameters]" />
</Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.appPrinter.
Visningsnamn Namnet som du vill ska visas i listan över utskriftsmål för en app.
Parametrar Alla parametrar som programmet behöver för att hantera begäran korrekt.

Exempel

<Package
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="desktop2">
  <Applications>
  <Application>
    <Extensions>
      <desktop2:Extension Category="windows.appPrinter">
        <desktop2:AppPrinter
          DisplayName="Send to Contoso"
          Parameters="/insertdoc %1" />
      </desktop2:Extension>
    </Extensions>
  </Application>
</Applications>
</Package>

Hitta ett exempel som använder det här tillägget Här

Dela teckensnitt med andra Windows-program

Dela dina anpassade teckensnitt med andra Windows-program.

Obs

Innan du kan skicka en app som använder det här tillägget till Store måste du först få godkännande från Store-teamet. Om du vill få godkännande går du till https://aka.ms/storesupport, klickar på Kontakta ossoch väljer de alternativ som är relevanta för att skicka appar till instrumentpanelen. Den här godkännandeprocessen hjälper till att säkerställa att det inte finns några konflikter mellan teckensnitt som installerats av din app och teckensnitt som är installerade med operativsystemet. Om du inte får något godkännande får du ett felmeddelande som liknar följande när du skickar in din app: "Verifieringsfel för godkännande av paket: Du kan inte använda tillägget windows.sharedFonts med det här kontot. Kontakta vårt supportteam om du vill begära behörighet att använda det här tillägget."

XML-namnområden

http://schemas.microsoft.com/appx/manifest/uap/windows10/4

Element och attribut i det här tillägget

<Extension Category="windows.sharedFonts">
    <SharedFonts>
      <Font File="[FontFile]" />
    </SharedFonts>
  </Extension>

Hitta den fullständiga schemareferensen här.

Namn Beskrivning
Kategori Alltid windows.sharedFonts.
Fil Filen som innehåller de teckensnitt som du vill dela.

Exempel

<Package
  xmlns:uap4="http://schemas.microsoft.com/appx/manifest/uap/windows10/4"
  IgnorableNamespaces="uap4">
  <Applications>
    <Application>
      <Extensions>
        <uap4:Extension Category="windows.sharedFonts">
          <uap4:SharedFonts>
            <uap4:Font File="Fonts\JustRealize.ttf" />
            <uap4:Font File="Fonts\JustRealizeBold.ttf" />
          </uap4:SharedFonts>
        </uap4:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Starta en Win32-process från en UWP-app (Universal Windows Platform)

Starta en Win32-process som körs i fullständigt förtroende.

XML-namnområden

http://schemas.microsoft.com/appx/manifest/desktop/windows10

Element och attribut i det här tillägget

<Extension Category="windows.fullTrustProcess" Executable="[executable file]">
  <FullTrustProcess>
    <ParameterGroup GroupId="[GroupID]" Parameters="[Parameters]"/>
  </FullTrustProcess>
</Extension>
Namn Beskrivning
Kategori Alltid windows.fullTrustProcess.
Grupp-ID En sträng som identifierar en uppsättning parametrar som du vill skicka till den körbara filen.
Parametrar Parametrar som du vill skicka till den körbara filen.

Exempel

<Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
         xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
         xmlns:rescap=
"http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
         xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10">
  ...
  <Capabilities>
      <rescap:Capability Name="runFullTrust"/>
  </Capabilities>
  <Applications>
    <Application>
      <Extensions>
          <desktop:Extension Category="windows.fullTrustProcess" Executable="fulltrustprocess.exe">
              <desktop:FullTrustProcess>
                  <desktop:ParameterGroup GroupId="SyncGroup" Parameters="/Sync"/>
                  <desktop:ParameterGroup GroupId="OtherGroup" Parameters="/Other"/>
              </desktop:FullTrustProcess>
           </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Det här tillägget kan vara användbart om du vill skapa ett användargränssnitt för Universell Windows-plattform som körs på alla enheter, men du vill att komponenterna i win32-programmet ska fortsätta att köras med fullständigt förtroende.

Skapa bara ett Windows-apppaket för din Win32-app. Lägg sedan till det här tillägget i paketfilen för UWP-appen. De här tilläggen anger att du vill starta en körbar fil i Windows-apppaketet. Om du vill kommunicera mellan din UWP-app och din Win32-app kan du konfigurera en eller flera apptjänster för att göra det. Du kan läsa mer om det här scenariot här.

Nästa steg

Har du frågor? Fråga oss på Stack Overflow. Vårt team övervakar dessa taggar. Du kan också fråga oss här.

  • Last updated on