activities

latest

false

Importante :

A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

Atividades do UIAutomation

Última atualização 25 de mar de 2025

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.

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]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.

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]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.

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]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)`

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]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.

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]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.

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]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.

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]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";var filePath = "C:\\samplefile.jpg";

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

 var sampleApp = uiAutomation.Attach(Descriptors.NewApplication.NewScreen);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);sampleApp.TakeScreenshot(Descriptors.NewApplication.NewScreen.NewElement, filePath);

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

 var fileExists = system.FileExists(filePath);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);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);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.

Nesta página