desktop7:Extension (パッケージ/アプリケーション内)
アプリの拡張ポイントを宣言します。
要素の階層
<desktop7:Extension>
構文
<desktop7:Extension
Category = 'A string that can have one of the following values: "windows.approvedShellExtension", "windows.controlPanelItem", "windows.service", "windows.mailProvider", "windows.shortcut", "windows.applicationRegistration", "windows.desktopAppMigration", "windows.systemFileAssociation", "windows.shadowCopyExcludeFiles", or "windows.errorReporting".'
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 -->
desktop7:ApprovedShellExtension?
desktop7:ControlPanelItem?
desktop7:Service?
desktop7:MailProvider?
desktop7:Shortcut?
desktop7:ApplicationRegistration?
desktop7:DesktopAppMigration?
desktop7:SystemFileAssociation?
desktop7:ShadowCopyExcludeFiles?
desktop7:ErrorReporting?
</desktop7:Extension>
キー
? 省略可能 (0 または 1)
属性と要素
属性
| 属性 | 説明 | データ型 | 必須 | 既定値 |
|---|---|---|---|---|
| カテゴリ | 拡張機能のカテゴリ。 | windows.approvedShellExtension、windows.controlPanelItem、windows.service、windows.mailProvider、windows.shortcut、windows.applicationRegistration、windows.desktopAppMigration、windows.systemFileAssociation、windows.shadowCopyExcludeFiles、または windows.errorReporting のいずれかの値を持つことができます。 | Yes | |
| [実行可能ファイル] | 既定の起動実行可能ファイル。 | 1 から 256 文字の長さの.exe値を持つ省略可能な文字列。末尾は でなければならず、、"、|、?または *を含<>:めることはできません。 拡張機能の既定の実行可能ファイルを指定します。 指定しない場合は、アプリに対して定義されている実行可能ファイルが使用されます。 指定した場合は、EntryPoint プロパティも使用されます。 その EntryPoint プロパティが指定されていない場合は、アプリに対して定義されている EntryPoint が使用されます。 |
いいえ | |
| EntryPoint | アクティブ化可能なクラス ID。 | 拡張機能を処理するタスクを表す、1 ~ 256 文字の値を持つ省略可能な文字列。 これは、通常、Windows ランタイムの型の完全な名前空間修飾名です。 EntryPoint が指定されていない場合は、アプリに対して定義されている EntryPoint が代わりに使用されます。 | いいえ | |
| RuntimeType | ランタイム プロバイダー。 この属性は、通常、アプリにフレームワークが混在している場合に使用されます。 | ピリオドで開始または終了できない、または次の文字を含むことができない長さが 1 ~ 255 文字の省略可能な文字列: 、、、、、、、、?、または *。 |\/":>< |
いいえ | |
| StartPage | 拡張ポイントを処理する Web ページです。 | 1 から 256 文字の長さの値を持つ省略可能な文字列(、":>|、、?、または *) を含<めることはできません。 |
いいえ | |
| uap10:TrustLevel | 拡張機能の信頼レベルを指定します。 | appContainer または mediumIL のいずれかの値を指定できる省略可能な文字列。 | いいえ | |
| uap10:RuntimeBehavior | 拡張機能の実行時の動作を指定します。 | windowsApp、packagedClassicApp、win32App のいずれかの値を指定できる省略可能な文字列。 | いいえ | |
| uap10:HostId | 拡張機能のホスト ランタイムの ID を指定します。 | 長さが 1 ~ 255 文字の英数字文字列。 文字で始まる必要があります。 | いいえ | |
| uap10:Parameters | 拡張機能に渡すコマンド ライン パラメーターが含まれています。 パッケージ ID を持つデスクトップ アプリでのみサポートされます。 | 1 ~ 32767 文字の長さの値を持ち、先頭と末尾に空白以外の文字を含む省略可能な文字列。 | いいえ | |
| uap11:Id | 拡張機能の識別子。 ID は、パッケージ内のすべての拡張機能に対して一意である必要があります。 | 先頭と末尾に空白以外の文字を含む、長さが 1 ~ 255 文字の省略可能な文字列。 | いいえ | |
| uap11:Subsystem | この属性は基本拡張構文から継承され、com4 拡張機能には適用されません。 構文検証以外の値は無視されます。 | コンソールまたはウィンドウのいずれかの値を指定できる省略可能な文字列。 | いいえ | |
| uap11:SupportsMultipleInstances | インスタンスを異なるプロセスで実行するかどうかを指定します。 既定値は false です。 | 省略可能なブール値。 | いいえ | |
| uap11:ResourceGroup | リソース管理のために拡張機能のアクティブ化をグループ化するために使用できるタグ (CPU やメモリなど)。 ResourceGroup に設定できる値は自由形式で柔軟です。 「Application@ResourceGroup」を参照してください。 | 1 ~ 255 文字の長さの値を持つオプションの英数字文字列。 文字で始まる必要があります。 | いいえ | |
| uap11:CurrentDirectoryPath | アプリケーション プロセスの起動時の初期ディレクトリを指定します。 | 、または の文字を<?>|含めることができない省略可能な文字列。* > |
いいえ | |
| uap11:Parameters | この属性は基本拡張構文から継承され、com4 拡張機能には適用されません。 構文検証以外の値は無視されます。 | 1 ~ 32767 文字の長さの値を持ち、先頭と末尾に空白以外の文字を含む省略可能な文字列。 | いいえ | |
| desktop7:CompatMode | この拡張機能の情報を従来の方法 (パッケージ化されていないアプリがレジストリを介して COM に型を登録するなど) で Windows に登録するか、新しいスコープの新しい方法で登録するかを指定します。 既定値は "モダン" です。 CompatMode="classic" には 、Microsoft.classicAppCompat_8wekyb3d8bbwe 機能が必要です。 | 省略可能な文字列 は、 クラシック または モダンのいずれかの値を持つことができます。 | いいえ | |
| desktop7:Scope | このパッケージが登録されているユーザー (ユーザー) として実行されている他のアプリケーションにのみ登録を表示するか、マシン (マシン) 上のすべてのユーザーとサービスに表示するかを指定します。 既定値は "user" です。 Scope="machine" には 、Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 機能が必要です。 | コンピューターまたはユーザーのいずれかの値を含めることができる省略可能な文字列。 | いいえ |
子要素
| 子要素 | 説明 |
|---|---|
| desktop7:ApprovedShellExtension | インストール時に、承認されたシェル拡張機能の一覧にシェル拡張機能を追加するように指定します。 |
| desktop7:ControlPanelItem | コントロール パネル項目として拡張機能を登録します。 |
| desktop7:Service | アプリと共にインストールおよび登録されるサービスを指定します。 |
| desktop7:MailProvider | アプリと共にインストールおよび登録されるサービスを指定します。 |
| desktop7:Shortcut | ファイルへのショートカットを作成します。 |
| desktop7:ApplicationRegistration | アプリケーションを登録します。 |
| desktop7:DesktopAppMigration | タイルとピンのアプリ移行エントリのセットを指定します。 |
| desktop7:SystemFileAssociation | アプリのシステム ファイルの関連付けを登録します。 |
| desktop7:ShadowCopyExcludeFiles | ボリューム シャドウ コピー サービス (VSS) によって除外される一連のファイルを指定します。 |
| desktop7:ErrorReporting | ボリューム シャドウ コピー サービス (VSS) によって除外される一連のファイルを指定します。 |
親要素
| Parent 要素 | 説明 |
|---|---|
| 拡張機能 (型: CT_ApplicationExtensions) | アプリケーションの 1 つ以上の拡張ポイントを定義します。 |
要件
| Item | 値 |
|---|---|
| 名前空間 | http://schemas.microsoft.com/appx/manifest/desktop/windows10/7 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| Minimum OS Version | Windows 10 (ビルド 19645) |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示