화면 캡처 시작
ms-screenclip: 및 ms-screenketch: URI 스키마를 사용하면 스크린샷을 자르거나 편집할 수 있습니다.
앱에서 새 스니핑 열기
ms-screenclip: URI를 사용하면 앱이 자동으로 열리고 새 스니핑을 시작할 수 있습니다. 결과 스니프는 사용자의 클립보드에 복사되지만 자동으로 여는 앱으로 다시 전달되지는 않습니다.
ms-screenclip: 다음 매개 변수를 사용합니다.
| 매개 변수 | 유형 | 필수 | 묘사 |
|---|---|---|---|
| 근원 | 문자열 | 아니요 | URI를 시작한 원본을 나타내는 자유형 문자열입니다. |
| 유형 | 문자열 | 아니요 | 요청된 특수 형식의 캡처를 나타내는 문자열 값입니다. 새 스니핑을 시작할 때 이 매개 변수를 생략할 수 있습니다. 지원되는 값은 스냅샷, 기록* |
| 클리핑 모드 | 문자열 | 아니요 | 스니프의 클리핑 형식을 나타내는 문자열 값입니다. 지원되는 값은 사각형, 자유형, 창입니다. |
| 지연_초 | 정수 | 아니요 | 1에서 30까지의 정수 값입니다. URI 호출과 스니핑이 시작되는 시간 사이의 지연 시간을 전체 초 단위로 지정합니다. |
| 콜백 형식 | 문자열 | 아니요 | 이 매개 변수를 사용할 수 없습니다. |
*
type=recording 코드 조각 도구 버전 11.2307 이상의 Windows 11 PC에서만 사용할 수 있으며 ms-screenclip에 대한 기본 처리기가 "화면 캡처" 대신 "조각 도구"로 설정된 경우에만 사용할 수 있습니다.
Snipping Tool 또는 Snip & Sketch 앱 시작
ms-screensketch: URI를 사용하면 프로그래밍 방식으로 캡처 도구 앱(Windows 11) 또는 Snip & Sketch 앱(Windows 10)을 실행하여, 주석을 달기 위해 해당 앱에서 특정 이미지를 열 수 있습니다.
ms-screensketch: 다음 매개 변수를 사용합니다.
| 매개 변수 | 타입 | 필수 | 묘사 |
|---|---|---|---|
| 공유 액세스 토큰 | 문자열 | 아니요 | 파일을 여는 데 사용할 토큰입니다. SharedStorageAccessManager.AddFile에서 가져왔습니다. 이 매개 변수를 생략하면 파일을 열지 않고 앱이 시작됩니다. |
| 보조 공유 액세스 토큰 | 문자열 | 아니요 | 스니프에 대한 메타데이터가 있는 JSON 파일을 식별하는 문자열입니다. 메타데이터에는 x,y 좌표 및/또는 userActivity배열이 있는 clipPoints 필드가 포함될 수 있습니다. |
| 근원 | 문자열 | 아니요 | URI를 시작한 원본을 나타내는 자유형 문자열입니다. |
| 일시적여부 | bool | 아니요 | True로 설정하면, 캡처 도구는 파일을 연 후 삭제를 시도합니다. |
다음 예제에서는 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-screensketchsecondarySharedAccessToken 매개 변수에 지정된 파일에 포함할 수 있는 항목을 보여 줍니다.
{
"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