Condividi tramite


Avvia lo strumento di cattura schermata

Gli schemi URI ms-screenclip: e ms-screensketch: consentono di avviare la cattura o la modifica degli screenshot.

Apri un nuovo snip dall'app

Il ms-screenclip: URI consente all'app di aprire e avviare automaticamente un nuovo snip. Lo snip risultante viene copiato negli Appunti dell'utente, ma non viene passato automaticamente all'app di apertura.

ms-screenclip: accetta i parametri seguenti:

Parametro Digitare Obbligatorio Descrizione
fonte corda No Stringa in formato libero per indicare l'origine dell'avvio dell'URI.
digitare corda No Valore stringa per indicare il tipo speciale di acquisizione richiesto. Questo parametro può essere omesso all'avvio di un nuovo snip. I valori supportati includono: snapshot, registrazione*
modalità di ritaglio corda No Un valore di stringa per indicare il tipo di ritaglio per snip. I valori supportati includono: Rectangle, Freeform, Window
ritardoInSecondi Int No Valore intero compreso tra 1 e 30. Specifica il ritardo, in secondi interi, tra la chiamata URI e l'inizio dello snipping.
callbackformat corda No Questo parametro non è disponibile.

* type=recording è disponibile solo nei PC Windows 11 con snipping tool versione 11.2307 o successiva e solo quando il gestore predefinito per ms-screenclip è impostato su "Strumento di ritaglio" invece di "Ritaglio schermo".

Avvio dello strumento di ritaglio o App Snip & Sketch

Il ms-screensketch: URI consente di avviare a livello di codice l'app Strumento di ritaglio (in Windows 11) o Snip & app Sketch (in Windows 10) e aprire un'immagine specifica in tale app per l'annotazione.

ms-screensketch: accetta i parametri seguenti:

Parametro Digitare Obbligatorio Descrizione
token di accesso condiviso corda No Token che identifica il file da aprire. Recuperato da SharedStorageAccessManager.AddFile. Se questo parametro viene omesso, l'app verrà avviata senza un file aperto.
token di accesso condiviso secondario corda No Stringa che identifica un file JSON con i metadati relativi allo snip. I metadati possono includere un campo clipPoints con una matrice di coordinate x,y e/o un userActivity.
fonte corda No Stringa libera per indicare la sorgente che ha avviato l'URI.
èTemporaneo bool No Se impostato su True, lo strumento di ritaglio tenterà di eliminare il file dopo l'apertura.

Nell'esempio seguente viene chiamato il metodo LaunchUriAsync per inviare un'immagine allo strumento di ritaglio dall'app dell'utente.

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

Nell'esempio seguente viene illustrato ciò che potrebbe contenere un file specificato dal parametro secondarySharedAccessToken di ms-screensketch:

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

Avviare un’app Windows utilizzando un URI