You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: hub/apps/develop/launch/launch-screen-snipping.md
+1-2Lines changed: 1 addition & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,8 +10,7 @@ ms.localizationpriority: medium
10
10
11
11
# Launch screen snipping (Legacy)
12
12
13
-
**This is a legacy method for activating the Snipping Tool. It will be deprecated on 05/01/2025. Please refer to the updated documentation: [Launch Snipping Tool
**This is a legacy method for activating the Snipping Tool. It will be deprecated on 05/01/2025. Please refer to the updated documentation: [Launch Snipping Tool](launch-snipping-tool.md).
15
14
16
15
The **ms-screenclip:** and **ms-screensketch:** URI schemes allows you to initiate snipping or editing screenshots.
Copy file name to clipboardExpand all lines: hub/apps/develop/launch/launch-snipping-tool.md
+15-11Lines changed: 15 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Launch Snipping Tool
3
3
description: This topic describes how to use the new protocol launch framework for Snipping Tool. Your app can use these URI schemes to launch the Snipping Tool capture overlay to create a new snip or recording.
4
4
5
5
ms.date: 01/30/2025
6
-
ms.topic: article
6
+
ms.topic: concept-article
7
7
keywords: windows 11, uri, snipping tool, capture
8
8
ms.localizationpriority: medium
9
9
ms.custom: RS5
@@ -13,15 +13,17 @@ ms.custom: RS5
13
13
14
14
This article specifies the protocol for integrating first and third-party applications with the Windows Snipping Tool using the **ms-clip:** URI (Uniform Resource Identifier) scheme. The protocol facilitates the capture of images and video with audio via the Snipping Tool. App callers can customize and choose which Snipping Tool features their app will display. The protocol is designed to offer flexibility, security, and ease of use, aligning closely with familiar HTTP-based interactions. This shift can make the protocol more intuitive for developers and facilitate its integration with web technologies.
15
15
16
-
Note: this protocol launch replaces the previous existing experience documented here:https://learn.microsoft.com/en-us/windows/uwp/launch-resume/launch-screen-snipping
16
+
> [!NOTE]
17
+
> This protocol launch replaces the previous existing experience documented [here](launch-screen-snipping.md).
17
18
18
19
## Supported Features include:
19
-
* Rectangle Capture
20
-
* Freeform Capture
21
-
* Window Capture
22
-
* Ability to launch directly into a Snip or Recording
23
-
* Customizing features available
24
-
* Autosave feature is available, but can be disabled
20
+
21
+
* Rectangle Capture
22
+
* Freeform Capture
23
+
* Window Capture
24
+
* Ability to launch directly into a Snip or Recording
25
+
* Customizing features available
26
+
* Autosave feature is available, but can be disabled
25
27
26
28
27
29
## Protocol Specification
@@ -46,7 +48,8 @@ Note: this protocol launch replaces the previous existing experience documented
46
48
47
49
The enabledModes parameter is designed to give developers granular control over the available UI options when invoking the ms-screenclip protocol. This allows for a tailored user experience that matches the specific requirements of the calling application. By specifying the enabledModes parameter, developers can restrict the user's choices in the Snipping Tool UI to ensure the output format meets their expectations.
48
50
49
-
Note: The FullScreenSnip mode is not supported in interactive mode at this time and should not be included in the enabledModes parameter.
51
+
> [!NOTE]
52
+
> The FullScreenSnip mode is not supported in interactive mode at this time and should not be included in the enabledModes parameter.
50
53
51
54
52
55
## Supported Modes
@@ -61,7 +64,8 @@ The **enabledModes** parameter can accept the following modes:
61
64
**SnippingAllModes:** Enables all snipping (image capture) modes (RectangleSnip, WindowSnip, FreeformSnip).
62
65
**All:** Enables all supported modes (RectangleSnip, WindowSnip, FreeformSnip, RectangleRecord).
63
66
64
-
**Important: If no enabledModes parameter is specified, the default behavior will allow all modes.**
67
+
> [!IMPORTANT]
68
+
> If no **enabledModes** parameter is specified, the default behavior will allow all modes.
65
69
66
70
## Examples
67
71
@@ -154,7 +158,7 @@ The use of the `SharedStorageAccessManager` class and of sharing tokens is subje
154
158
155
159
## Retrieving a token
156
160
157
-
I have developed a sample application to test the process of calling the protocol and converting the response token into media. Use the [SharedStorageAccessManager] (https://learn.microsoft.com/en-us/uwp/api/windows.applicationmodel.datatransfer.sharedstorageaccessmanager?view=winrt-26100)library to obtain the token.
161
+
I have developed a sample application to test the process of calling the protocol and converting the response token into media. Use the [SharedStorageAccessManager] (/uwp/api/windows.applicationmodel.datatransfer.sharedstorageaccessmanager) library to obtain the token.
158
162
159
163
[Sample app code for retrieving tokens ](https://microsoft.visualstudio.com/Apps/_git/SnipProtocolTestApp?path=/SnipProtocolTestApp/MainPage.xaml.cs&version=GBmaster&line=139&lineEnd=140&lineStartColumn=1&lineEndColumn=1&lineStyle=plain&_a=contents)
0 commit comments