Iniciar recorte de ecrã

Os esquemas de URI ms-screenclip: e ms-screensketch: permitem iniciar o recorte ou edição de capturas de tela.

Abra uma nova captura da sua aplicação

O ms-screenclip: URI permite que seu aplicativo abra e inicie automaticamente um novo trecho. O trecho resultante é copiado para a área de transferência do usuário, mas não é automaticamente passado de volta para a aplicação inicial.

ms-screenclip: usa os seguintes parâmetros:

Parâmetro	Tipo	Necessário	Descrição
fonte	corda	Não	Uma cadeia de caracteres de forma livre para indicar a fonte que iniciou o URI.
tipo	string	Não	Um valor de cadeia de caracteres para indicar qual tipo especial de captura é solicitado. Esse parâmetro pode ser omitido ao iniciar um novo trecho. Os valores suportados incluem: instantâneo, gravação*
modo de recorte	string	Não	Um valor de cadeia de caracteres para indicar o tipo de recorte para o trecho. Os valores suportados incluem: Rectangle, Freeform, Window
atrasoEmSegundos	Int	Não	Um valor inteiro, de 1 a 30. Especifica o atraso, em segundos completos, entre a chamada URI e quando o recorte começa.
formato de retorno de chamada	string	Não	Este parâmetro não está disponível.

* type=recording está disponível apenas em PCs com Windows 11 com a Ferramenta de Recorte versão 11.2307 ou mais recente, e somente quando o gestor padrão para ms-screenclip está definido como "Ferramenta de Recorte" em vez de "Recorte de Ecrã".

Iniciando a ferramenta de recorte ou o aplicativo Snip & Sketch

O ms-screensketch: URI permite iniciar programaticamente o aplicativo Ferramenta de Recorte (no Windows 11) ou o aplicativo Snip & Sketch (no Windows 10) e abrir uma imagem específica nesse aplicativo para anotação.

ms-screensketch: usa os seguintes parâmetros:

Parâmetro	Tipo	Necessário	Descrição
tokenDeAcessoPartilhado	string	Não	Um token que identifica o arquivo a ser aberto. Obtido em SharedStorageAccessManager.AddFile. Se esse parâmetro for omitido, o aplicativo será iniciado sem um arquivo aberto.
tokenDeAcessoPartilhadoSecundário	string	Não	Uma cadeia de caracteres que identifica um arquivo JSON com metadados sobre o trecho. Os metadados podem incluir um clipPoints campo com uma matriz de coordenadas x,y e/ou um userActivity.
fonte	string	Não	Uma cadeia de caracteres de forma livre para indicar a fonte que iniciou o URI.
isTemporário	Bool	Não	Se definido como True, a Ferramenta de Recorte tentará excluir o arquivo depois de abri-lo.

O exemplo a seguir chama o método LaunchUriAsync para enviar uma imagem para a Ferramenta de Recorte a partir do aplicativo do usuário.

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-screensketch:edit?source=MyApp&isTemporary=false&sharedAccessToken=2C37ADDA-B054-40B5-8B38-11CED1E1A2D"));

O exemplo a seguir ilustra o que um arquivo especificado pelo parâmetro secondarySharedAccessToken de ms-screensketch pode conter:

{
  "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\"}"
}

Conteúdo relacionado

Iniciar uma aplicação do Windows com um URI