Avviare la cattura schermo

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

Aprire un nuovo snip dall'app

L'URI ms-screenclip: 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 seguenti parametri:

Parametro	Type	Obbligatorio	Descrizione
source	string	no	Stringa a mano libera per indicare l'origine che ha avviato l'URI.
type	string	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*
clippingMode	string	no	Valore stringa per indicare il tipo di ritaglio per lo snip. I valori supportati includono: Rectangle, Freeform, Window
delayInSeconds	int	no	Un valore intero, compreso tra 1 e 30. Specifica il ritardo, in secondi interi, tra la chiamata URI e l'inizio dello snipping.
callbackformat	string	no	Questo parametro non è disponibile.

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

Avvio dello strumento di ritaglio o snip & Sketch App

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

ms-screensketch: accetta i seguenti parametri:

Parametro	Type	Obbligatorio	Descrizione
sharedAccessToken	string	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.
secondarySharedAccessToken	string	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 oggetto userActivity.
source	string	no	Stringa a mano libera per indicare l'origine che ha avviato l'URI.
isTemporary	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 a Snipping Tool 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 il contenuto di 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\"}"
}