Starta skärmsnippning

Med ms-screenclip: och ms-screensketch: URI-scheman kan du initiera skärmklipp eller redigera skärmbilder.

Öppna ett nytt klipp från din app

ms-screenclip: URI gör att din app automatiskt kan öppna upp och starta ett nytt klipp. Det resulterande kodstycket kopieras till användarens Urklipp, men skickas inte automatiskt tillbaka till öppningsappen.

ms-screenclip: tar följande parametrar:

Parameter	Typ	Krävs	Beskrivning
källa	sträng	Nej	En frihandssträng som anger källan som startade URI:n.
typ	sträng	Nej	Ett strängvärde som anger vilken särskild typ av avbildning som begärs. Den här parametern kan utelämnas när du startar ett nytt klipp. Värden som stöds är: ögonblicksbild, inspelning*
klippningsläge	sträng	Nej	Ett strängvärde som anger urklippstypen för kodfragmentet. Värden som stöds är: Rektangel, Fri form, Fönster
fördröjningISekunder	Int	Nej	Ett heltalsvärde, från 1 till 30. Anger fördröjningen i hela sekunder mellan URI-anropet och när klippningen börjar.
callbackformat	sträng	Nej	Den här parametern är inte tillgänglig.

* type=recording är endast tillgängligt på Windows 11-datorer med Snipping Tool version 11.2307 eller senare, och endast när standardhanteraren för ms-screenclip är inställd på "Snipping Tool" i stället för "Skärmurklipp".

Starta Skärmklippsverktyget eller Snip & Sketch-appen

Med ms-screensketch: URI kan du programmatiskt starta Snipping Tool-appen (på Windows 11) eller Snip & Sketch-appen (i Windows 10) och öppna en specifik bild i appen för anteckningar.

ms-screensketch: tar följande parametrar:

Parameter	Typ	Krävs	Beskrivning
Delat åtkomsttoken	sträng	Nej	En token som identifierar filen som ska öppnas. Hämtad från SharedStorageAccessManager.AddFile. Om den här parametern utelämnas startas appen utan att en fil öppnas.
sekundär delad åtkomsttoken	sträng	Nej	En sträng som identifierar en JSON-fil med metadata om kodfragmentet. Metadata kan innehålla ett ClipPoints- fält med en matris med x,y-koordinater och/eller en userActivity-.
källa	sträng	Nej	En frihandssträng som anger källan som startade URI:n.
ärTillfällig	Bool	Nej	Om värdet är True försöker Snipping Tool ta bort filen när den har öppnats.

I följande exempel anropas metoden LaunchUriAsync för att skicka en bild till Snipping Tool från användarens app.

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-screensketch:edit?source=MyApp&isTemporary=false&sharedAccessToken=2C37ADDA-B054-40B5-8B38-11CED1E1A2D"));

I följande exempel visas vad en fil som anges av parametern secondarySharedAccessToken för ms-screensketch kan innehålla:

{
  "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\"}"
}

Relaterat innehåll

Starta en Windows-app med en URI-