启动屏幕截取

ms-screenclip: 和 ms-screensketch: URI 方案支持启动截图或编辑屏幕截图。

从应用打开新截图

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

ms-screenclip：采用以下参数：

参数	类型​​	必需	说明
source	string	否	一个自由格式字符串，指示启动 URI 的源。
type	string	否	一个字符串值，指示请求了哪种具体类型的捕获。 启动新的截图时，可以省略此参数。 支持的值包括：快照、录制*
clippingMode	string	否	一个字符串值，指示截图的剪辑类型。 支持的值包括：Rectangle、Freeform、Window
delayInSeconds	int	否	介于 1 至 30 之间的整数值。 指定 URI 调用与开始进行截图之间的延迟（以整秒表示）。
callbackformat	string	否	此参数不可用。

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

启动“截图工具”或“截图和草图”应用

ms-screensketch: URI 支持以编程方式启动截图工具应用（Windows 11 上）或截图和草图应用（Windows 10 上），并在该应用中打开特定图像进行注释。

ms-screensketch：采用以下参数：

参数	类型​​	必需	说明
sharedAccessToken	string	否	标识要打开文件的令牌。 已从 SharedStorageAccessManager.AddFile 检索。 如果省略此参数，将在不打开文件的情况下启动应用。
secondarySharedAccessToken	string	否	一个字符串，标识包含有关截图的元数据的 JSON 文件。 元数据可能包括具有 x、y 坐标数组的 clipPoints 字段和/或 userActivity。
source	string	否	一个自由格式字符串，指示启动 URI 的源。
isTemporary	bool	否	如果设置为 True，截图工具将在打开文件后尝试删除该文件。

下面的示例调用 LaunchUriAsync 方法，以将图像从用户的应用发送到截图工具。

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

下面的示例说明了由 ms-screensketch 的 secondarySharedAccessToken 参数指定的文件可能包含的内容：

{
  "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\"}"
}