Iniciar a captura de tela

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

Abrir uma nova captura usando aplicativos

O URI ms-screenclip: permite aos aplicativos abrir e iniciar uma nova captura automaticamente. A captura resultante é copiada para a área de transferência do usuário, mas não é devolvida automaticamente aos aplicativos que estão iniciando.

O ms-screenclip: usa os seguintes parâmetros:

Parâmetro	Type	Obrigatória	Descrição
origem	string	não	Uma sequência de forma livre para indicar a fonte que iniciou o URI.
tipo	string	não	Um valor de sequência para indicar qual tipo especial de captura é solicitado. Este parâmetro pode ser omitido ao iniciar uma nova captura. Os valores com suporte incluem: instantâneo e gravação*
clippingMode	string	não	Um valor de sequência para indicar o tipo de recorte da captura. Os valores com suporte incluem: retângulo, forma livre e janela
delayInSeconds	int	não	Um valor inteiro, de 1 a 30. Especifica o atraso, em segundos completos, entre a chamada de URI e o início da captura.
callbackformat	string	não	Este parâmetro não está disponível.

* type=recording está disponível somente em computadores com Windows 11 que tem a Ferramenta de Captura na versão 11.2307 ou em versões mais recentew, e somente quando o manipulador padrão para ms-screenclip está definido como “Ferramenta de Captura” em vez de “Recorte de Tela”.

Iniciar a Ferramenta de Captura ou o Aplicativo Captura e Esboço

O URI ms-screensketch: permite que você inicie programaticamente o aplicativo Ferramenta de Recorte (no Windows 11) ou o aplicativo Recorte e Esboço (no Windows 10) e abra uma imagem específica nesse aplicativo para anotação.

O ms-screensketch: usa os seguintes parâmetros:

Parâmetro	Type	Obrigatória	Descrição
sharedAccessToken	string	não	Um token que identifica o arquivo a ser aberto. Obtido de SharedStorageAccessManager.AddFile. Se este parâmetro for omitido, os aplicativos serão iniciados sem um arquivo aberto.
secondarySharedAccessToken	string	não	Uma sequência que identifica um arquivo JSON com metadados sobre a captura. Os metadados podem incluir um campo clipPoints com uma matriz de coordenadas x,y ou um userActivity.
source	string	não	Uma sequência de forma livre para indicar a fonte que iniciou o URI.
isTemporary	bool	não	Se definido como Verdadeiro, a Ferramenta de Captura tentará excluir o arquivo após abri-lo.

O exemplo a seguir chama o método LaunchUriAsync para enviar uma imagem para a Ferramenta de Captura dos aplicativos 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 do 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\"}"
}