画面切り取りの起動
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) または Snip > Sketch アプリ (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\"}"
}