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 codice l'app Snipping Tool (in Windows 11) o 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\"}"
}