啟動螢幕剪取
ms-screenclip: 和 ms-screensketch: URI 配置可讓您起始剪貼或編輯螢幕快照。
從您的應用程式中開啟一個新的片段
ms-screenclip: URI 可讓您的應用程式自動開啟並開始新的剪輯。 產生的片段將複製到使用者的剪貼簿,但不會自動傳回開啟的應用程式。
ms-screenclip: 採用以下參數:
參數 | 類型 | 必要 | 描述 |
---|---|---|---|
來源 | 字串 | 否 | 一個自由格式字串,指示啟動 URI 的來源。 |
type | 字串 | 否 | 一個字串值,指示請求哪種特殊類型的擷取。 開始新片段時可以省略此參數。 支援的值包括:快照、錄製* |
clippingMode | 字串 | 否 | 字串值,表示剪貼的裁剪類型。 支援的值包括:矩形、自由形狀、窗口 |
delayInSeconds | int | 否 | 整數值,從 1 到 30。 指定 URI 呼叫與截圖開始之間的延遲 (以整秒為單位)。 |
callbackformat | 字串 | 否 | 此參數無法使用。 |
* type=recording
僅在裝有截圖工具版本 11.2307 或更高版本的 Windows 11 電腦上可用,並且僅當 ms-screenclip 的預設處理程序設定為「截圖工具」而不是「螢幕剪輯」時。
啟動截圖工具或 Snip & Sketch 應用程式
ms-screensketch: URI 可讓您以程式設計方式啟動 Snipping Tool 應用程式(在 Windows 11 上)或 Snip & Sketch 應用程式(在 Windows 10 上),並在該應用程式中開啟特定影像以供批注。
ms-screensketch: 採用以下參數:
參數 | 類型 | 必要 | 描述 |
---|---|---|---|
sharedAccessToken | 字串 | 否 | 標識要開啟的文件的標記。 從 SharedStorageAccessManager.AddFile 擷取。 如果省略此參數,應用程式將在不開啟檔案的情況下啟動。 |
secondarySharedAccessToken | 字串 | 否 | 標識 JSON 檔案的字串,其中包含有關片段的中繼資料。 中繼資料可以包括具有 x、y 座標數組和/或 userActivity 的 clipPoints 欄位。 |
來源 | 字串 | 否 | 一個自由格式字串,指示啟動 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\"}"
}