uap:Protocol (Windows 10)
声明 windows.protocol 类型的应用扩展点。 URI 关联指示已注册应用以使用指定方案处理 URI。
元素层次结构
<uap:Protocol>
语法
<uap:Protocol
Name = 'A string with a value between 2 and 39 characters in length that contains numbers, lowercase letters, periods ("."), plus signs ("+"), or dashes ("-"). The string cannot start with a period (".").'
DesiredView = 'A string that can have one of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".'
ReturnResults = 'An optional string that can have one of the following values: "none", "always", "optional".' >
<!-- Child elements -->
uap:Logo?
& uap:DisplayName?
& desktop7:ProgId
</uap:Protocol>
密钥
?
可选 (零个或一个) &
交错连接器 (可以按任意顺序出现)
特性和元素
属性
属性 | 说明 | 数据类型 | 必须 | 默认值 |
---|---|---|---|---|
名称 | URI 方案的名称 (如 mailto ) 。 此名称对于包必须是唯一的。 |
值长度介于 2 到 39 个字符之间的字符串,包含数字、小写字母、句点 () . ,以及 (+ ) 或短划线 (- ) 。 字符串不能以句点 (. ) 开头。 |
是 | |
DesiredView | 启动约会时要使用的屏幕空间量。 | 可以具有以下值之一的字符串: default、 useLess、 useHalf、 useMore 或 useMinimum。 | 否 | |
ReturnResults | 指定应用在通过 URI 激活调用时是否返回值。 | 可具有以下值之一的可选字符串:“none” (不返回值) ,“always” (URI 激活将始终返回结果) ,“可选” (URI 激活将返回结果(如果使用 LaunchUriForResultsAndContinueAsync) 激活结果)。 | 否 |
子元素
子元素 | 描述 |
---|---|
uap:DisplayName | 可向用户显示的友好名称。 |
uap:Logo | 包含图像的文件的路径。 |
desktop7:ProgId | 编程标识符 (可以与 CLSID 关联的 ProgID) 。 |
父元素
父元素 | 描述 |
---|---|
uap:Extension | 声明应用的扩展点。 |
示例
以下示例取自其中一个 SDK 示例的包清单。
<Applications>
<Application
Id="App"
StartPage="default.html">
<Extensions>
<uap:Extension
Category="windows.protocol">
<uap:Protocol
Name="alsdk" />
</uap:Extension>
</Extensions>
</Application>
</Applications>
另请参阅
概念应用协定和扩展
要求
项 | 值 |
---|---|
Namespace | http://schemas.microsoft.com/appx/manifest/uap/windows10 |
Minimum OS Version | Windows 10版本 1511 (内部版本 10586) |