画面切り取りの起動

ms-screenclip: および ms-screensketch: URI スキームを使用すると、スクリーンショットの画面切り取り機能と編集を開始できます。

アプリから新しい切り取り領域を開く

ms-screenclip: URI を使用すると、新しい切り取り領域をアプリで自動的に開いて開始できます。 結果の切り取り領域はユーザーのクリップボードにコピーされますが、開いているアプリには自動的には戻されません。

ms-screenclip: は次のパラメーターを受け取ります。

パラメーター	タイプ	Required	説明
source	string	no	URI を起動したソースを示す自由形式の文字列。
type	string	いいえ	要求された特殊な種類のキャプチャを示す文字列値。 このパラメーターは、新しい切り取りを開始するときには省略できます。 サポートされる値には、スナップショット、レコーディング*などがあります。
clippingMode	string	no	切り取り領域のクリッピングの種類を示す文字列値。 サポートされている値には、四角形、フリー​​フォーム、ウィンドウがあります。
delayInSeconds	int	no	1 から 30 までの整数値。 URI 呼び出しから切り取り機能が開始されるまでの遅延を秒単位で指定します。
callbackformat	string	no	このパラメーターは使用できません。

* type=recording は、Snipping Tool バージョン 11.2307 以降の Windows 11 PC でのみ使用できます。ms-screenclip の既定のハンドラーが "Screen Clipping" ではなく "Snipping Tool" に設定されている場合にのみ使用できます。

Snipping Tool または切り取り & スケッチ アプリの起動

ms-screensketch: URI を使用すると、Snipping Tool アプリ (Windows 11 上) または切り取り & スケッチ アプリ (Windows 10 上) をプログラムで起動し、注釈用にそのアプリ内の特定の画像を開くことができます。

ms-screensketch: は次のパラメーターを受け取ります。

パラメーター	タイプ	Required	説明
sharedAccessToken	string	いいえ	開くファイルを識別するトークン。 SharedStorageAccessManager.AddFile から取得されます。 このパラメーターを省略すると、ファイルを開いていない状態でアプリが起動されます。
secondarySharedAccessToken	string	no	切り取り領域に関するメタデータを含む JSON ファイルを識別する文字列。 このメタデータには、x、y 座標の配列を含む clipPoints フィールドと userActivity を含めることができます。
source	string	no	URI を起動したソースを示す自由形式の文字列。
isTemporary	bool	いいえ	True に設定すると、Snipping Tool はファイルを開いた後にそのファイルの削除を試みます。

次の例では、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"));

次の例は、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\"}"
}