Starten von Ausschnitt und Skizze

Der ms-screenclip: und ms-screensketch: URI-Schemas ermöglichen Ihnen das Initiieren des Ausschneidens oder Bearbeitens von Screenshots.

Öffnen eines neuen Snips aus Ihrer App

Der ms-screenclip:-URI ermöglicht Ihrer App, automatisch einen neuen Snip zu öffnen und zu starten. Der resultierende Snip wird in die Zwischenablage des Benutzers kopiert, aber nicht automatisch an die öffnende App zurück gegeben.

ms-screenclip: übernimmt die folgenden Parameter:

Parameter	Type	Erforderlich	Beschreibung
Quelle	Zeichenfolge	Nein	Eine Freihandformzeichenfolge, die die Quelle angibt, die den URI gestartet hat.
Typ	Zeichenfolge	Nein	Ein Zeichenfolgenwert, der angibt, welcher spezielle Aufnahmetyp angefordert wird. Dieser Parameter kann beim Starten eines neuen Snips weggelassen werden. Unterstützte Werte sind: Momentaufnahme, Aufzeichnung*
clippingMode	Zeichenfolge	Nein	Ein Zeichenfolgenwert, der den Clippingtyp für den Snip angibt. Unterstützte Werte: Rechteck, Freihandform, Fenster
delayInSeconds	INT	Nein	Ganzzahliger Wert zwischen 1 und 30. Gibt die Verzögerung zwischen dem URI-Aufruf und dem Beginn des Snippings in ganzen Sekunden an.
callbackformat	Zeichenfolge	Nein	Dieser Parameter ist nicht verfügbar.

* type=recording ist nur auf Windows 11-PCs mit Snipping Tool, Version 11.2307 oder höher, verfügbar und nur, wenn der Standardhandler für ms-screenclip auf „Snipping Tool“ anstelle von „Bildschirmausschnitt“ festgelegt ist.

Starten des Snipping-Tools oder der „Ausschneiden und skizzieren“-App

Mit dem ms-screensketch:-URI können Sie die Snipping Tool-App (unter Windows 11) oder die „Ausschneiden und skizzieren“-App (unter Windows 10) programmgesteuert starten und ein bestimmtes Bild in dieser App zur Anmerkung öffnen.

ms-screensketch: übernimmt die folgenden Parameter:

Parameter	Type	Erforderlich	Beschreibung
sharedAccessToken	Zeichenfolge	Nein	Ein Token, das die zu öffnende Datei identifiziert. Von SharedStorageAccessManager.AddFile abgerufen. Wenn dieser Parameter nicht angegeben wird, wird die App ohne geöffnete Datei gestartet.
secondarySharedAccessToken	Zeichenfolge	Nein	Eine Zeichenfolge, die eine JSON-Datei mit Metadaten zum Snip identifiziert. Die Metadaten können ein clipPoints-Feld mit einem Array mit x,y-Koordinaten und/oder einer userActivity enthalten.
source	Zeichenfolge	Nein	Eine Freihandformzeichenfolge, die die Quelle angibt, die den URI gestartet hat.
isTemporary	bool	Nein	Wenn dieser Wert auf „True“ festgelegt ist, versucht das Snipping Tool, die Datei nach dem Öffnen zu löschen.

Im folgenden Beispiel wird die LaunchUriAsync-Methode aufgerufen, um ein Bild aus der App des Benutzers an das Snipping Tool zu senden.

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

Das folgende Beispiel veranschaulicht, was eine Datei durch den parameter secondarySharedAccessToken von ms-screensketch spezifizierte Datei enthalten kann:

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