Take Screenshot

Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e a salva em um arquivo.

Essa API deve ser adicionada após Abrir ou Anexar.

Definição

Namespace: UiPath.UIAutomationNext.API.Models

Montagem: UiPath.UIAutomationNext.API.Models (na dll UiPath.UIAutomationNext.API.Models)

Sobrecarregas

Sobrecarga	Description
TakeScreenshot(IElementDescriptor, TakeScreenshotOptions)	Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado por um descritor de um elemento do Repositório de Objetos.
TakeScreenshot(IElementDescriptor, String)	Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado por um descritor de um elemento do Repositório de Objetos, especificando o nome do arquivo.
TakeScreenshot(String, TakeScreenshotOptions)	Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado por uma string do Repositório de Objetos, juntamente com outras configurações.
TakeScreenshot(String, String)	Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado por uma string do Repositório de Objetos, juntamente com outras configurações.
TakeScreenshot(RuntimeTarget, TakeScreenshotOptions)	Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado por uma instância de runtime de um elemento do Repositório de Objetos, juntamente com outras configurações.
TakeScreenshot(TargetAnchorableModel, TakeScreenshotOptions)	Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado pelo objeto TargetAnchorableModel , juntamente com outras configurações.
TakeScreenshot(TargetAnchorableModel, String)	Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado pelo objeto TargetAnchorableModel , enquanto especifica o nome do arquivo.

TakeScreenshot(IElementDescriptor, TakeScreenshotOptions)

Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado por um descritor de um elemento do Repositório de Objetos.

TakeScreenhot(
    IElementDescriptor elementDescriptor,
    TakeScreenshotOptions takeScreenshotOptions)

elementDescriptor IElementDescriptor

O descritor do elemento do qual a captura de tela será feita. Deixe null para fazer uma captura de tela de toda a área de trabalho.

takeScreenshotOptions TakeScreenshotOptions

Opções adicionais para personalizar a captura de tela. Você pode optar por personalizar:

• TargetOptions:
  • Tempo limite — especifica o tempo (em segundos) para aguardar que a API seja executada antes de gerar o erro SelectorNotFoundException . O valor padrão é 30 segundos.
  • AtrasoApós - Tempo de atraso (em segundos) após executar a API. O tempo padrão é 0,3 segundo (300 milissegundos).
  • AtrasoAntes - Tempo de atraso (em segundos) antes de a API começar a realizar qualquer operação. O tempo padrão é 0,2 segundo (200 milissegundos).
• FileName – O nome do arquivo que você deseja salvar.

TakeScreenshot(IElementDescriptor, String)

Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado por um descritor de um elemento do Repositório de Objetos, especificando o nome do arquivo.

TakeScreenhot(
    IElementDescriptor elementDescriptor,
    string fileName)

elementDescriptor IElementDescriptor

O descritor do elemento do qual a captura de tela será feita. Deixe null para fazer uma captura de tela de toda a área de trabalho.

Nome do arquivo String

O nome do arquivo que você deseja salvar.

TakeScreenshot(String, TakeScreenshotOptions)

Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado por uma string do Repositório de Objetos, juntamente com outras configurações.

TakeScreenhot(
    string target,
    TakeScreenshotOptions takeScreenshotOptions)

target String

O destino de onde se fará a captura de tela, identificado por uma string do Repositório de Objetos. Deixe null para fazer uma captura de tela de toda a área de trabalho.

takeScreenshotOptions TakeScreenshotOptions

Opções adicionais para personalizar a captura de tela. Você pode optar por personalizar:

• TargetOptions:
  • Tempo limite — especifica o tempo (em segundos) para aguardar que a API seja executada antes de gerar o erro SelectorNotFoundException . O valor padrão é 30 segundos.
  • AtrasoApós - Tempo de atraso (em segundos) após executar a API. O tempo padrão é 0,3 segundo (300 milissegundos).
  • AtrasoAntes - Tempo de atraso (em segundos) antes de a API começar a realizar qualquer operação. O tempo padrão é 0,2 segundo (200 milissegundos).
• FileName – O nome do arquivo que você deseja salvar.

TakeScreenshot(String, String)

Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado por uma string do Repositório de Objetos, juntamente com outras configurações.

TakeScreenhot(
    string target,
    string fileName)

target String

O destino de onde se fará a captura de tela, identificado por uma string do Repositório de Objetos. Deixe null para fazer uma captura de tela de toda a área de trabalho.

Nome do arquivo String

O nome do arquivo que você deseja salvar.

TakeScreenshot(RuntimeTarget, TakeScreenshotOptions)

Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado por uma instância de runtime de um elemento do Repositório de Objetos, juntamente com outras configurações.

TakeScreenhot(
    RuntimeTarget target,
    TakeScreenshotOptions takeScreenshotOptions)

target RuntimeTarget

O destino de onde se fará a captura de tela, identificado por uma instância de runtime de um elemento do Repositório de Objetos. Deixe null para fazer uma captura de tela de toda a área de trabalho.

takeScreenshotOptions TakeScreenshotOptions

Opções adicionais para personalizar a captura de tela. Você pode optar por personalizar:

• TargetOptions:
  • Tempo limite — especifica o tempo (em segundos) para aguardar que a API seja executada antes de gerar o erro SelectorNotFoundException . O valor padrão é 30 segundos.
  • AtrasoApós - Tempo de atraso (em segundos) após executar a API. O tempo padrão é 0,3 segundo (300 milissegundos).
  • AtrasoAntes - Tempo de atraso (em segundos) antes de a API começar a realizar qualquer operação. O tempo padrão é 0,2 segundo (200 milissegundos).
• FileName – O nome do arquivo que você deseja salvar.

TakeScreenshot(TargetAnchorableModel, TakeScreenshotOptions)

Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado pelo objeto TargetAnchorableModel , juntamente com outras configurações.

TakeScreenhot(
    TargetAnchorableModel target,
    TakeScreenshotOptions takeScreenshotOptions)

target TargetAnchorableModel

O destino do qual obter a captura de tela, identificado pelo objeto TargetAnchorableModel . Sair null para fazer uma captura de tela de toda a área de trabalho.

takeScreenshotOptions TakeScreenshotOptions

Opções adicionais para personalizar a captura de tela. Você pode optar por personalizar:

• TargetOptions:
  • Tempo limite — especifica o tempo (em segundos) para aguardar que a API seja executada antes de gerar o erro SelectorNotFoundException . O valor padrão é 30 segundos.
  • AtrasoApós - Tempo de atraso (em segundos) após executar a API. O tempo padrão é 0,3 segundo (300 milissegundos).
  • AtrasoAntes - Tempo de atraso (em segundos) antes de a API começar a realizar qualquer operação. O tempo padrão é 0,2 segundo (200 milissegundos).
• FileName – O nome do arquivo que você deseja salvar.

TakeScreenshot(TargetAnchorableModel, String)

Obtém uma captura de tela de um elemento de interface gráfica ou aplicativo especificado e o salva em um arquivo, identificado pelo objeto TargetAnchorableModel , enquanto especifica o nome do arquivo.

TakeScreenhot(
    TargetAnchorableModel target, 
    string fileName)

target TargetAnchorableModel

O destino do qual obter a captura de tela, identificado pelo objeto TargetAnchorableModel . Sair null para fazer uma captura de tela de toda a área de trabalho.

Nome do arquivo String

O nome do arquivo que você deseja salvar.

Exemplo de código

Aqui está um breve passo a passo de uma implementação de código de exemplo.

Essa linha de código configura o caminho do arquivo onde a captura de tela é salva.

var filePath = "C:\\samplefile.jpg";

Esse comando conecta-se a uma tela de um aplicativo já aberto.

var sampleApp = uiAutomation.Attach(Descriptors.NewApplication.NewScreen);

A API TakeScreenshot é invocada aqui, capturando a imagem da tela do elemento recém-especificado em sua tela e, posteriormente, salvando-o no caminho do arquivo definido.

sampleApp.TakeScreenshot(Descriptors.NewApplication.NewScreen.NewElement, filePath);

Verifica se o arquivo de captura de tela existe no filePath fornecido.

var fileExists = system.FileExists(filePath);

Por fim, a instrução verifica que o arquivo de captura de tela foi salvo com sucesso no destino filePath.

testing.VerifyAreEqual(fileExists, true);

Adição de opções

Você pode adicionar opções em seu código de duas maneiras.

Uma maneira de adicionar opções é usar a sobrecarga correta. Para fazer isso, pressione Ctrl + Space, e IntelliSense aparece, permitindo que você navegue e selecione sua sobrecarga preferida.Você pode decidir selecionar a sobrecarga onde você tem os parâmetros configurados com antecedência. Os parâmetros opcionais são indicados entre colchetes.

Se quiser inicializar uma única configuração como windowResize, você pode usar esta sintaxe:

var sampleApp = uiAutomation.Attach(Descriptors.NewApplication.NewScreen, windowResize: NWindowResize.Restore);

Outra maneira de adicionar opções é usar uma sobrecarga de opção comum, como Attach, e emparelhá-la com a classe Options.Isso oferece um pouco mais de flexibilidade na personalização de seus parâmetros.