Iniciar recorte de pantalla
Los esquemas URI ms-screenclip: y ms-screensketch: te permiten iniciar recortar o editar capturas de pantalla.
Abre una nueva captura desde tu aplicación
El URI ms-screenclip: permite que la aplicación se abra automáticamente e inicie un nuevo recorte. El snip resultante se copia en el Portapapeles del usuario, pero no se pasa automáticamente a la aplicación de apertura.
ms-screenclip: toma los parámetros siguientes:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| fuente | cadena | No | Cadena de forma libre para indicar el origen que inició el URI. |
| tipo | cadena | No | Valor de cadena para indicar qué tipo especial de captura se solicita. Este parámetro se puede omitir al iniciar un nuevo snip. Entre los valores admitidos se incluyen: instantánea, grabación* |
| modo de recorte | cadena | No | Valor de texto para indicar el tipo de recorte para el fragmento. Entre los valores admitidos se incluyen: Rectángulo, Forma libre, Ventana |
| delayInSeconds | Int | No | Valor entero, de 1 a 30. Especifica el retraso, en segundos completos, entre la llamada de URI y cuando comienza el recorte. |
| formato de devolución de llamada | cuerda | No | Este parámetro no está disponible. |
*
type=recording solo está disponible en equipos con Windows 11 con la herramienta Snipping Tool versión 11.2307 o posterior, y solo cuando el controlador predeterminado para ms-screenclip está establecido en "Herramienta de recorte de pantalla" en lugar de "Recorte de pantalla".
Iniciar la Herramienta de Recortes o Snip & Sketch App
El ms-screensketch: URI te permite iniciar mediante programación la aplicación Herramienta de Recortes (en Windows 11) o la aplicación Snip & Sketch (en Windows 10) y abrir una imagen específica en esa aplicación para anotar.
ms-screensketch: toma los parámetros siguientes:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| sharedAccessToken | cadena | No | Token que identifica el archivo que se va a abrir. Recuperado de SharedStorageAccessManager.AddFile. Si se omite este parámetro, la aplicación se iniciará sin un archivo abierto. |
| Token de Acceso Compartido Secundario | cadena | No | Cadena que identifica un archivo JSON con metadatos sobre el snip. Los metadatos pueden incluir un campo clipPoints con una matriz de coordenadas x,y y/o un userActivity. |
| fuente | cadena | No | Cadena de forma libre para indicar el origen que inició el URI. |
| esTemporal | Bool | No | Si se establece en True, Snipping Tool intentará eliminar el archivo después de abrirlo. |
En el ejemplo siguiente se llama al método LaunchUriAsync para enviar una imagen a Snipping Tool desde la aplicación del usuario.
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-screensketch:edit?source=MyApp&isTemporary=false&sharedAccessToken=2C37ADDA-B054-40B5-8B38-11CED1E1A2D"));
En el ejemplo siguiente se muestra lo que un archivo especificado por el parámetro secondarySharedAccessToken de ms-screensketch puede contener:
{
"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\"}"
}
