Iniciar a captura de tela

  • Artigo

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