启动屏幕截图

ms-screenclip： 和 ms-screensketch： URI 方案允许你启动截取或编辑屏幕截图功能。

打开您的应用程序中新建的截图

ms-screenclip： URI 允许应用自动打开并启动新的截图。 生成的截图将复制到用户的剪贴板，但不会自动传回打开的应用。

ms-screenclip： 采用以下参数：

参数	类型	必填	描述
源	字符串	不	一个任意多边形字符串，用于指示启动 URI 的源。
类型	字符串	不	一个字符串值，指示请求了哪种特殊类型的捕获。 启动新的片段时，可以省略此参数。 支持的值包括：快照、录制*
裁剪模式	字符串	不	一个字符串值，用于指示切片的剪辑类型。 支持的值包括：矩形、任意多边形、窗口
延迟时间（秒）	int	不	一个整数值，从 1 到 30。 指定 URI 调用与截取开始时间之间的延迟（以整秒为单位）。
回调格式 (callbackformat)	字符串	不	此参数不可用。

* type=recording 仅在 Windows 11 电脑（具有截图工具版本 11.2307 或更高版本）上可用，并且仅当 ms-screenclip 的默认处理程序设置为“截图工具”而不是“屏幕剪辑”。

启动剪贴工具或剪贴 & 草图应用

ms-screensketch： URI 允许你以编程方式启动截图工具应用（在 Windows 11 上）或 Snip & 草图应用（在 Windows 10 上），并在该应用中打开特定图像进行批注。

ms-screensketch： 采用以下参数：

参数	类型	必填	描述
sharedAccessToken	字符串	不	标识要打开的文件的令牌。 从 SharedStorageAccessManager.AddFile检索。 如果省略此参数，则应用将在未打开文件的情况下启动。
二级共享访问令牌	字符串	不	一个字符串，用于标识 JSON 文件，其中包含有关截图的元数据。 元数据可能包括一个带有 x、y 坐标数组的 clipPoints 字段和/或一个 userActivity。
源	字符串	不	一个任意多边形字符串，用于指示启动 URI 的源。
是否临时	布尔	不	如果设置为 True，在打开文件时，Snipping 工具将尝试删除该文件。

以下示例调用 LaunchUriAsync 方法，以便从用户的应用中将图像发送到 Snipping Tool。

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-screensketch:edit?source=MyApp&isTemporary=false&sharedAccessToken=2C37ADDA-B054-40B5-8B38-11CED1E1A2D"));

以下示例演示了 secondarySharedAccessToken 参数指定的 ms-screensketch 可能包含的文件：

{
  "clipPoints": [
    {
      "x": 0,
      "y": 0
    },
    {
      "x": 2080,
      "y": 0
    },
    {
      "x": 2080,
      "y": 780
    },
    {
      "x": 0,
      "y": 780
    }
  ],
  "userActivity": "{\"$schema\":\"http://activity.windows.com/user-activity.json\",\"UserActivity\":\"type\",\"1.0\":\"version\",\"cross-platform-identifiers\":[{\"platform\":\"windows_universal\",\"application\":\"Microsoft.MicrosoftEdge_8wekyb3d8bbwe!MicrosoftEdge\"},{\"platform\":\"host\",\"application\":\"edge.activity.windows.com\"}],\"activationUrl\":\"microsoft-edge:https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"contentUrl\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"visualElements\":{\"attribution\":{\"iconUrl\":\"https://www.microsoft.com/favicon.ico?v2\",\"alternateText\":\"microsoft.com\"},\"description\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"backgroundColor\":\"#FF0078D7\",\"displayText\":\"Use snipping tool to capture screenshots - Windows Help\",\"content\":{\"$schema\":\"http://adaptivecards.io/schemas/adaptive-card.json\",\"type\":\"AdaptiveCard\",\"version\":\"1.0\",\"body\":[{\"type\":\"Container\",\"items\":[{\"type\":\"TextBlock\",\"text\":\"Use snipping tool to capture screenshots - Windows Help\",\"weight\":\"bolder\",\"size\":\"large\",\"wrap\":true,\"maxLines\":3},{\"type\":\"TextBlock\",\"text\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"size\":\"normal\",\"wrap\":true,\"maxLines\":3}]}]}},\"isRoamable\":true,\"appActivityId\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\"}"
}

相关内容

使用 URI 启动 Windows 应用