Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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\"}"
}