desktop:Extension

Deklaruje bod rozšiřitelnosti aplikace.

Hierarchie elementů

< >

     <aplikace>

          <\Application>

               <\Extensions>

                    <\Desktop:Extension>

Syntax

<desktop:Extension
  Category = 'A string value that can be one of the following values: "windows.fullTrustProcess", "windows.startupTask", "windows.toastNotificationActivation", or "windows.searchProtocolHandler".'
  Executable = 'An optional string with a value 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 isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value 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 = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup =  'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with an alphabetic character.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  previewappcompat:CompatMode = 'An optional string that can have one of the following values: "classic" or "modern".'
  previewappcompat:Scope = 'An optional string that can be one of the following values: "user" or "machine".'
  uap11:Id = 'An optional string with a value between 1 and 256 characters in length.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'A string that can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'A string that can have one of the following values: "machine" or "user".' >

  <!-- Child elements -->
  desktop:FullTrustProcess?
  desktop:StartupTask?
  desktop:ToastNotificationActivation?
  desktop:SearchProtocolHandler?

</desktop:Extension>

Klíč

? volitelné (nula nebo jedna)

Atributy a prvky

Atributy

Atribut	Popis	Datový typ	Požadovaný	Výchozí hodnota
kategorie	Kategorie rozšíření.	Řetězcová hodnota, která může být jednou z následujících hodnot: windows.fullTrustProcess, windows.startupTask, windows.toastNotificationActivationnebo windows.searchProtocolHandler.	Ano
spustitelného	Výchozí spustitelný soubor.	Volitelný řetězec s hodnotou od 1 do 256 znaků, který musí končit .exe a nesmí obsahovat tyto znaky: <, >, :, ", |, ?nebo *. Určuje výchozí spustitelný soubor rozšíření. Pokud není zadaný, použije se spustitelný soubor definovaný pro aplikaci. Pokud je zadána, entrypoint vlastnost je také použita. Pokud tato vlastnost EntryPoint není zadaná, použije se položka definovaná pro aplikaci.	Ne
EntryPoint	ID aktivovatelné třídy.	Volitelný řetězec s hodnotou od 1 do 256 znaků, který představuje úkol zpracovávající rozšíření. Obvykle se jedná o plně kvalifikovaný název oboru názvů typu Prostředí Windows Runtime. Pokud není zadaný EntryPoint, použije se místo toho PoložkaPoint definovaný pro aplikaci.	Ne
RuntimeType	Zprostředkovatel modulu runtime. Tento atribut se obvykle používá v případě, že v aplikaci existují smíšené architektury.	Volitelný řetězec s hodnotou od 1 do 255 znaků, který nemůže začínat nebo končit tečkou nebo obsahovat tyto znaky: <, >, :, ", /, \, |, ?nebo *.	Ne
startpage	Webová stránka, která zpracovává bod rozšiřitelnosti.	Volitelný řetězec s hodnotou od 1 do 256 znaků, který nesmí obsahovat tyto znaky: <, >, :, ", |, ?nebo *.	Ne
uap10:TrustLevel	Určuje úroveň důvěryhodnosti rozšíření.	Volitelný řetězec, který může mít jednu z následujících hodnot: appContainer nebo středníil .	Ne
uap10:RuntimeBehavior	Určuje chování běhu rozšíření.	Volitelný řetězec, který může mít jednu z následujících hodnot: windowsApp, packagedClassicAppnebo win32App.	Ne
uap10:HostId	Určuje ID modulu runtime hostitele pro rozšíření.	Volitelný alfanumerický řetězec s hodnotou od 1 do 255 znaků. Musí začínat abecedním znakem.	Ne
uap10:Parameters	Obsahuje parametry příkazového řádku pro předání rozšíření. Podporuje se jenom u desktopových aplikací, které mají identitu balíčku.	Volitelný řetězec s hodnotou od 1 do 32767 znaků s jiným než prázdným znakem na začátku a konci.	Ne
uap11:Id	Identifikátor rozšíření. ID musí být jedinečné pro všechna rozšíření v balíčku.	Volitelný řetězec s hodnotou od 1 do 255 znaků s jiným než prázdným znakem na začátku a konci.	Ne
uap11:Subsystem	Subsystém cílený rozšířením.	Volitelný řetězec, který může mít jednu z následujících hodnot: konzoly nebo windows.	Ne
uap11:SupportsMultipleInstances	Určuje, jestli se instance mají spouštět v různých procesech. Výchozí hodnota je false.	Volitelná logická hodnota.	Ne
uap11:ResourceGroup	Značka, kterou můžete použít k seskupení aktivací rozšíření pro účely správy prostředků (například procesoru a paměti). Hodnota, kterou můžete nastavit ResourceGroup, je volná a flexibilní. Viz Application@ResourceGroup.	Volitelný alfanumerický řetězec s hodnotou od 1 do 255 znaků. Musí začínat písmenem.	Ne
uap11:CurrentDirectoryPath	Určuje počáteční adresář při spuštění procesu aplikace. Tento atribut podporuje makra. Další informace najdete v tématu Makra ve schématu manifestu balíčku.	Volitelný řetězec, který nesmí obsahovat tyto znaky: <, >, |, ?nebo *. >	Ne
uap11:Parameters	Subsystém cílený rozšířením. Tento atribut podporuje makra. Další informace najdete v tématu Makra ve schématu manifestu balíčku.	Volitelný řetězec s hodnotou od 1 do 32767 znaků s jiným než prázdným znakem na začátku a konci.	Ne
desktop7:CompatMode	Určuje, jestli se informace o tomto rozšíření registrují v systému Windows klasickými způsoby (např. rozbalené aplikace registrují typy pomocí modelu COM prostřednictvím registru) nebo v nových vymezených způsobech. Výchozí hodnota je "moderní". CompatMode="classic" vyžaduje schopnost Microsoft.classicAppCompat_8wekyb3d8bbwe.	Volitelný řetězec může mít jednu z následujících hodnot: klasické nebo moderní.	Ne
desktop7:Rozsah	Určuje, jestli jsou registrace viditelné jenom pro jiné aplikace spuštěné jako uživatel, který má tento balíček zaregistrovaný (uživatel), nebo jestli jsou viditelné všem uživatelům a službám na počítači (počítači). Výchozí hodnota je "user". Scope="machine" vyžaduje Microsoft.classicAppCompatElevated_8wekyb3d8bbwe schopnost.	Volitelný řetězec, který může mít jednu z následujících hodnot: počítač nebo uživatele.	Ne

Podřízené prvky

Podřízený prvek	Popis
FullTrustProcess	Představuje desktopový proces, který běží v plné důvěryhodnosti.
startuptask	Představuje desktopový proces, který se spouští při spuštění aplikace.
toastNotificationActivation	Umožňuje příjem informačních zpráv v aplikaci.
SearchProtocolHandler	Představuje desktopový proces, který zpracovává vyhledávací protokol aplikace.

Nadřazené prvky

Nadřazený prvek	Popis
rozšíření	Deklaruje bod rozšiřitelnosti balíčku.

Poznámky

Požadavky

Položka	Hodnota
Namespace	http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
minimální verze operačního systému	Windows 10 verze 1607 (build 14393)