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

Contenuto correlato

Avviare un’app Windows utilizzando un URI