起動画面の切り取り
ms-screenclip: と ms-screenketch: URI スキームを使用すると、スクリーンショットの切り取りまたは編集を開始できます。
アプリから新しいスクリーンショットを開く
ms-screenclip: URI を使用すると、アプリを自動的に開いて新しい切り取りを開始できます。 結果の切り取りはユーザーのクリップボードにコピーされますが、開いているアプリには自動的に戻されません。
ms-screenclip: は次のパラメーターを受け取ります。
| パラメーター | 種類 | 必須 | 説明 |
|---|---|---|---|
| 源 | 糸 | いいえ | URI を起動したソースを示すフリーフォーム文字列。 |
| 種類 | 糸 | いいえ | 要求される特殊な種類のキャプチャを示す文字列値。 このパラメーターは、新しい切り取りを開始するときに省略できます。 サポートされる値は次のとおりです。スナップショット、記録* |
| クリッピングモード | 糸 | いいえ | 切り取りのクリッピングの種類を示す文字列値。 サポートされる値は次のとおりです。Rectangle、Freeform、Window |
| 秒単位の遅延 | 整数 | いいえ | 1 ~ 30 の整数値。 URI 呼び出しから切り取りを開始するまでの遅延 (秒単位) を指定します。 |
| コールバック形式 | 糸 | いいえ | このパラメーターは使用できません。 |
*
type=recording は、Snipping Tool バージョン 11.2307 以降の Windows 11 PC でのみ使用でき、ms-screenclip の既定のハンドラーが "画面のクリッピング" ではなく "Snipping Tool" に設定されている場合にのみ使用できます。
切り取りツールまたは Snip & Sketch アプリの起動
ms-screensketch: URI を使用すると、プログラムで Snipping Tool アプリ (Windows 11) または Snip & Sketch アプリ (Windows 10) を起動し、そのアプリ内の特定の画像を開いて注釈を付けられます。
ms-screensketch の : は次のパラメーターを受け取ります。
| パラメーター | 種類 | 必須 | 説明 |
|---|---|---|---|
| 共有アクセス トークン | 糸 | いいえ | 開くファイルを識別するトークン。 SharedStorageAccessManager.AddFileから取得されます。 このパラメーターを省略すると、ファイルを開かずにアプリが起動されます。 |
| セカンダリー共有アクセス トークン | 糸 | いいえ | 切り取りに関するメタデータを含む JSON ファイルを識別する文字列。 メタデータには、x、y 座標、または userActivityの配列を持つ clipPoints フィールドを含めることができます。 |
| 源 | 糸 | いいえ | URI を起動したソースを示すフリーフォーム文字列。 |
| 一時的である | 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\"}"
}
関連コンテンツ
URI を使用して Windows アプリを起動する
Windows developer