共用方式為


desktop9:Package/Extensions) 中的擴充功能 (

宣告應用程式的擴充點。

元素階層

<套件>

    <應用程式>

         <應用程式>

              <擴充功能>

                   <desktop9:Extension>

Syntax

<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>

答案

? 選擇性 (零或一個)

屬性和元素

屬性

屬性 描述 資料類型 必要 預設值
類別 延伸模組的類別。 可以具有下列其中一個值的字串: windows.fileExplorerClassicContextMenuHandlerwindows.fileExplorerClassicDragDropContextMenuHandler Yes
可執行檔 默認啟動可執行檔。 長度介於 1 到 256 個字元之間的選擇性字串,其長度必須以 .exe 結尾,且不能包含下列字元:<、、|:>"? 或 。* 它會指定延伸模組的預設可執行檔。 如果未指定,則會使用為應用程式定義的可執行檔。 如果指定,也會使用 EntryPoint 屬性。 如果未指定 EntryPoint 屬性,則會使用為應用程式定義的 EntryPoint。 No
EntryPoint 可啟用的類別識別碼。 長度介於 1 到 256 個字元之間的選擇性字串,代表處理延伸的工作。 這必須符合 Windows 執行階段類型的完整命名空間名稱。 如果未指定 EntryPoint,則會改用為應用程式定義的 EntryPoint。 No
RuntimeType 運行時間提供者。 當應用程式中有混合架構時,通常會使用這個屬性。 長度介於 1 到 255 個字元之間的選擇性字串,長度不能以句號開頭或結尾,或包含下列字元:<、、\:/|">? 或 。* No
StartPage 處理擴充點的網頁 長度介於 1 到 256 個字元之間的選擇性字串,不能包含下列字元:<、、、>:"|?或 。* No
uap10:TrustLevel 指定延伸模組的信任層級。 可具有下列其中一個值的選擇性字串: appContainermediumIL No
uap10:RuntimeBehavior 指定延伸模組的運行時間行為。 可具有下列其中一個值的選擇性字串: windowsApppackagedClassicAppwin32App No
uap10:HostId 指定擴充功能的主機運行時間標識碼。 長度介於 1 到 255 個字元之間的英數位元字串。 必須以字母開頭。 No
uap10:Parameters 包含要傳遞至延伸模組的命令行參數。 僅支援具有套件身分識別的桌面應用程式。 長度介於 1 到 32767 個字元的選擇性字串,其開頭和結尾為非空格符。 No
uap11:Id 延伸模組的標識碼。 封裝中所有延伸模組的標識碼都必須是唯一的。 長度介於 1 到 255 個字元的選擇性字串,其開頭和結尾為非空格符。 No
uap11:子系統 此屬性繼承自基底延伸模組語法,不適用於 com4 延伸模組。 除了語法驗證之外,會忽略此值。 可具有下列其中一個值的選擇性字串: 控制台視窗 No
uap11:SupportsMultipleInstances 指定實例是否應該在不同的進程中執行。 預設值為 false。 選擇性布爾值。 No
uap11:ResourceGroup 標記,可用來將擴充功能啟用群組在一起,以供資源管理之用 (例如 CPU 和記憶體) 。 您可以設定 ResourceGroup 的值是自由格式且有彈性的。 請參閱 Application@ResourceGroup 長度介於 1 到 255 個字元之間的選擇性英數位元字串。 必須以字母開頭。 No
uap11:CurrentDirectoryPath 指定應用程式進程啟動時的初始目錄。 此屬性支持宏。 如需詳細資訊,請參閱 套件指令清單架構中的宏 無法包含下列字元的選擇性字串:<、、、|?、 或 *>。 > No
uap11:Parameters 此屬性繼承自基底延伸模組語法,不適用於 com4 延伸模組。 除了語法驗證之外,會忽略此值。 此屬性支持宏。 如需詳細資訊,請參閱 套件指令清單架構中的宏 長度介於 1 到 32767 個字元的選擇性字串,其開頭和結尾為非空格符。 No
desktop7:CompatMode 指定此延伸模組的資訊是以傳統方式向 Windows 註冊, (例如,透過登錄) 或以更具範圍的方式向 COM 註冊未封裝的應用程式註冊類型。 預設值為 「modern」。 CompatMode=“classic” 需要 Microsoft.classicAppCompat_8wekyb3d8bbwe 功能。 的選擇性字串可以有下列其中一個值: 傳統新式 No
desktop7:Scope 指定註冊是否只有以使用者身分註冊 (使用者) 執行的其他應用程式,或是否對 (計算機上的所有使用者和服務顯示註冊) 。 預設值為 「user」。 Scope=“machine” 需要 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 功能。 可具有下列其中一個值的選擇性字串: 計算機使用者 No

子元素

子項目 描述
FileExplorerClassicContextMenuHandler 為已封裝的傳統型應用程式註冊操作功能表處理程式殼層延伸的舊版 IContextMenu 實作。
FileExplorerClassicDragDropContextMenuHandler 讓 Windows 傳統型橋接器 應用程式註冊 Windows 事件記錄。

父元素

父元素 描述
延伸模組 定義應用程式的一或多個擴充點。

規格需求

Item
命名空間 http://schemas.microsoft.com/appx/manifest/desktop/windows10/9
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
OS 最低版本 Windows 11 版本 21H2 (組建 22159)