desktop9:Extension (w pakiecie/rozszerzeniach)

Deklaruje punkt rozszerzalności aplikacji.

Hierarchia elementów

> pakietu<

     <Applications>

          <Application>

               <Rozszerzenia>

                    <desktop9:Extension>

Składnia

<desktop9:Extension 
  Category = 'A string that can have one of the following values: "windows.fileExplorerClassicContextMenuHandler" or "windows.fileExplorerClassicDragDropContextMenuHandler".'
  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 *.'
  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 alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  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.' 
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  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 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 = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".' >

  <!-- Child elements -->
  desktop9:FileExplorerClassicContextMenuHandler
  desktop9:FileExplorerClassicDragDropContextMenuHandler?

</desktop9:Extension>

Klucz

? opcjonalne (zero lub jeden)

Atrybuty i elementy

Atrybuty

Atrybut	Opis	Typ danych	Wymagane	Wartość domyślna
Kategorii	Kategoria rozszerzenia.	Ciąg, który może mieć jedną z następujących wartości: windows.fileExplorerClassicContextMenuHandler lub windows.fileExplorerClassicDragDropContextMenuHandler.	Tak
wykonywalnego	Domyślny plik wykonywalny uruchamiania.	Opcjonalny ciąg o długości od 1 do 256 znaków, który musi kończyć się .exe i nie może zawierać następujących znaków: <, >, :, ", |, ?lub *. Określa domyślny plik wykonywalny rozszerzenia. Jeśli nie zostanie określony, zostanie użyty plik wykonywalny zdefiniowany dla aplikacji. Jeśli zostanie określona, zostanie również użyta właściwość EntryPoint. Jeśli ta właściwość programu EntryPoint nie zostanie określona, zostanie użyty program EntryPoint zdefiniowany dla aplikacji.	Nie
EntryPoint	Aktywowany identyfikator klasy.	Opcjonalny ciąg o długości od 1 do 256 znaków reprezentujący zadanie obsługujące rozszerzenie. Jest to zwykle w pełni kwalifikowana nazwa przestrzeni nazw typu środowiska uruchomieniowego systemu Windows. Jeśli program EntryPoint nie zostanie określony, zamiast tego zostanie użyty program EntryPoint zdefiniowany dla aplikacji.	Nie
RuntimeType	Dostawca środowiska uruchomieniowego. Ten atrybut jest używany zwykle w przypadku mieszanych struktur w aplikacji.	Opcjonalny ciąg o długości od 1 do 255 znaków, który nie może rozpoczynać się lub kończyć kropką lub zawierać następujące znaki: <, >, :, ", /, \, |, ?lub *.	Nie
StartPage	Strona internetowa, która obsługuje punkt rozszerzalności.	Opcjonalny ciąg o długości od 1 do 256 znaków, który nie może zawierać następujących znaków: <, >, :, ", |, ?lub *.	Nie
uap10:TrustLevel	Określa poziom zaufania rozszerzenia.	Opcjonalny ciąg, który może mieć jedną z następujących wartości: appContainer lub mediumIL.	Nie
uap10:RuntimeBehavior	Określa zachowanie czasu wykonywania rozszerzenia.	Opcjonalny ciąg, który może mieć jedną z następujących wartości: windowsApp, packagedClassicApplub win32App.	Nie
uap10:HostId	Określa identyfikator środowiska uruchomieniowego hosta dla rozszerzenia.	Ciąg alfanumeryczny o długości od 1 do 255 znaków. Musi zaczynać się literą.	Nie
uap10:Parameters	Zawiera parametry wiersza polecenia, które mają być przekazywane do rozszerzenia. Obsługiwane tylko w przypadku aplikacji klasycznych, które mają tożsamość pakietu.	Opcjonalny ciąg z wartością z zakresu od 1 do 32767 znaków o długości innej niż biały znak na początku i na końcu.	Nie
uap11:Id	Identyfikator rozszerzenia. Identyfikator musi być unikatowy dla wszystkich rozszerzeń w pakiecie.	Opcjonalny ciąg z wartością z zakresu od 1 do 255 znaków o długości innej niż biały znak na początku i na końcu.	Nie
uap11:Podsystem	Podsystem przeznaczony dla rozszerzenia.	Opcjonalny ciąg, który może mieć jedną z następujących wartości: konsoli lub windows.	Nie
uap11:SupportsMultipleInstances	Określa, czy wystąpienia powinny być uruchamiane w różnych procesach. Wartość domyślna to false.	Opcjonalna wartość logiczna.	Nie
uap11:ResourceGroup	Tag, którego można użyć do grupowania aktywacji rozszerzeń razem na potrzeby zarządzania zasobami (na przykład procesora CPU i pamięci). Wartość, którą można ustawić, jest dowolna i elastyczna. Zobacz Application@ResourceGroup.	Opcjonalny ciąg alfanumeryczny o długości od 1 do 255 znaków. Musi zaczynać się literą.	Nie
uap11:CurrentDirectoryPath	Określa katalog początkowy podczas uruchamiania procesu aplikacji. Ten atrybut obsługuje makra. Aby uzyskać więcej informacji, zobacz Makra w schemacie manifestu pakietu.	Opcjonalny ciąg, który nie może zawierać tych znaków: <, >, |, ?lub *. >	Nie
uap11:Parameters	Podsystem przeznaczony dla rozszerzenia. Ten atrybut obsługuje makra. Aby uzyskać więcej informacji, zobacz Makra w schemacie manifestu pakietu.	Opcjonalny ciąg z wartością z zakresu od 1 do 32767 znaków o długości innej niż biały znak na początku i na końcu.	Nie
desktop7:CompatMode	Określa, czy informacje o tym rozszerzeniu są rejestrowane w systemie Windows w klasyczny sposób (np. rozpakowane aplikacje rejestrują typy za pomocą modelu COM za pośrednictwem rejestru) czy w nowy, bardziej zakresowy sposób. Wartość domyślna to "modern". CompatMode="classic" wymaga możliwości Microsoft.classicAppCompat_8wekyb3d8bbwe.	Opcjonalny ciąg może mieć jedną z następujących wartości: klasycznych lub nowoczesnych.	Nie
desktop7:Zakres	Określa, czy rejestracje są widoczne tylko dla innych aplikacji uruchomionych jako użytkownik, który ma ten pakiet zarejestrowany (użytkownik), czy też są one widoczne dla wszystkich użytkowników i usług na komputerze (komputerze). Wartość domyślna to "user". Funkcja Scope="machine" wymaga możliwości Microsoft.classicAppCompatElevated_8wekyb3d8bbwe.	Opcjonalny ciąg, który może mieć jedną z następujących wartości: maszyny lub użytkownik.	Nie

Elementy podrzędne

Element podrzędny	Opis
FileExplorerClassicContextMenuHandler	Rejestruje starszą implementację IContextMenu rozszerzenia powłoki programu obsługi menu kontekstowego dla spakowanej aplikacji klasycznej.
FileExplorerClassicDragDropContextMenuHandler	Umożliwia aplikacjom mostka klasycznego systemu Windows rejestrowanie w celu rejestrowania zdarzeń systemu Windows.

Elementy nadrzędne

Element nadrzędny	Opis
rozszerzeń	Definiuje co najmniej jeden punkt rozszerzalności aplikacji.

Wymagania

Przedmiot	Wartość
Namespace	http://schemas.microsoft.com/appx/manifest/desktop/windows10/9
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
minimalna wersja systemu operacyjnego	Windows 11 w wersji 21H2 (kompilacja 22159)