Iniciar el recorte de pantalla

Los esquemas de URI ms-screenclip: y ms-screenketch: permiten iniciar recortes o editar capturas de pantalla.

Abrir un nuevo recorte desde la aplicación

El URI ms-screenclip: permite que la aplicación se abra automáticamente e inicie un nuevo recorte. El recorte resultante se copia en el Portapapeles del usuario, pero no se pasa automáticamente a la aplicación que se abre.

ms-screenclip: usa los parámetros siguientes:

Parámetro	Type	Obligatorio	Descripción
de origen	string	no	Cadena de forma libre para indicar el origen que inició el URI.
type	cadena	no	Valor de cadena para indicar qué tipo especial de captura se solicita. Este parámetro se puede omitir al iniciar un nuevo recorte. Entre los valores admitidos se incluyen: instantánea, grabación*
clippingMode	string	no	Valor de cadena para indicar el tipo de recorte. Entre los valores admitidos se incluyen: Rectángulo, Forma libre, Ventana
delayInSeconds	int	no	Un valor entero entre 1 y 30. Especifica el retraso, en segundos completos, entre la llamada del URI y el inicio del recorte.
callbackformat	string	no	Este parámetro no está disponible.

* type=recording solo está disponible en equipos con Windows 11 con la versión 11.2307 o posterior de la Herramienta Recortes, y solo cuando el controlador predeterminado para ms-screenclip está configurado como "Herramienta Recortes" en lugar de "Recorte de pantalla".

Inicio de las aplicaciones Herramienta Recortes o Recorte y anotación

Ms-screensketch : URI permite iniciar mediante programación la aplicación Snipping Tool (en Windows 11) o la aplicación Snip & Sketch (en Windows 10) y abrir una imagen específica en esa aplicación para la anotación.

ms-screensketch: usa los parámetros siguientes:

Parámetro	Type	Obligatorio	Descripción
sharedAccessToken	string	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.
secondarySharedAccessToken	string	no	Cadena que identifica un archivo JSON con metadatos sobre el recorte. Los metadatos pueden incluir un campo clipPoints con una matriz de coordenadas x,y o un userActivity.
source	string	no	Cadena de forma libre para indicar el origen que inició el URI.
isTemporary	bool	no	Si se define como verdadero, la Herramienta Recortes intentará eliminar el archivo después de abrirlo.

En el ejemplo siguiente se llama al método LaunchUriAsync para enviar una imagen a la Herramienta Recortes 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 puede contener un archivo especificado por el parámetro secondarySharedAccessToken de 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\"}"
}