Realizar captura

Toma una captura de pantalla de un elemento de IU o una aplicación especificados y lo guarda en un archivo.

Esta API debe añadirse después de Abrir o Adjuntar.

Definición

Espacio de nombres: UiPath.UIAutomationNext.API.Models

Ensamblado: UiPath.UIAutomationNext.API.Models (en UiPath.UIAutomationNext.API.Models dll)

Sobrecargas

Sobrecarga	Descripción
TakeScreenshot(IElementDescriptor, TakeScreenshotOptions)	Realiza una captura de pantalla de un elemento o aplicación de la IU especificados y la guarda en un archivo, identificado por un descriptor de un elemento del Repositorio de objetos.
TakeScreenshot(IElementDescriptor, String)	Realiza una captura de pantalla de un elemento o aplicación de la IU especificados y la guarda en un archivo, identificado por un descriptor de un elemento del Repositorio de objetos, al tiempo que especifica el nombre del archivo.
TakeScreenshot(String, TakeScreenshotOptions)	Realiza una captura de pantalla de un elemento de IU o una aplicación especificados y la guarda en un archivo, identificado por una cadena del Repositorio de objetos, junto con otras configuraciones.
TakeScreenshot(String, String)	Realiza una captura de pantalla de un elemento de IU o una aplicación especificados y la guarda en un archivo, identificado por una cadena del Repositorio de objetos, junto con otras configuraciones.
TakeScreenshot(RuntimeTarget, TakeScreenshotOptions)	Realiza una captura de pantalla de un elemento de IU o una aplicación especificados y la guarda en un archivo, identificado por una instancia de tiempo de ejecución de un elemento del Repositorio de objetos, junto con otras configuraciones.
TakeScreenshot(TargetAnchorableModel, TakeScreenshotOptions)	Realiza una captura de pantalla de un elemento de IU o aplicación especificados y la guarda en un archivo, identificado por el objeto TargetAnchorableModel , junto con otras configuraciones.
TakeScreenshot(TargetAnchorableModel, String)	Realiza una captura de pantalla de un elemento de la IU o una aplicación especificados y la guarda en un archivo, identificado por el objeto TargetAnchorableModel , al tiempo que especifica el nombre del archivo.

TakeScreenshot(IElementDescriptor, TakeScreenshotOptions)

Realiza una captura de pantalla de un elemento o aplicación de la IU especificados y la guarda en un archivo, identificado por un descriptor de un elemento del Repositorio de objetos.

TakeScreenhot(
    IElementDescriptor elementDescriptor,
    TakeScreenshotOptions takeScreenshotOptions)

elementDescriptor IElementDescriptor

El descriptor del elemento del que tomar la captura de pantalla. Deje null para tomar una captura de pantalla de todo el escritorio.

takeScreenshotOptions TakeScreenshotOptions

Opciones adicionales para personalizar la captura de pantalla. Puedes elegir personalizar:

• TargetOptions:
  • Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la API antes de que se produzca el error SelectorNotFoundException . El valor predeterminado es 30 segundos.
  • RetrasoDespués : tiempo de retraso (en segundos) después de ejecutar la API. La cantidad de tiempo predeterminada es de 0,3 segundos (300 milisegundos).
  • RetrasoAntes : tiempo de retraso (en segundos) antes de que la API comience a realizar cualquier operación. La cantidad de tiempo predeterminada es de 0,2 segundos (200 milisegundos).
• FileName : el nombre del archivo que quieres guardar.

TakeScreenshot(IElementDescriptor, String)

Realiza una captura de pantalla de un elemento o aplicación de la IU especificados y la guarda en un archivo, identificado por un descriptor de un elemento del Repositorio de objetos, al tiempo que especifica el nombre del archivo.

TakeScreenhot(
    IElementDescriptor elementDescriptor,
    string fileName)

elementDescriptor IElementDescriptor

El descriptor del elemento del que tomar la captura de pantalla. Deje null para tomar una captura de pantalla de todo el escritorio.

Nombre de archivo Cadena

El nombre del archivo que desea guardar.

TakeScreenshot(String, TakeScreenshotOptions)

Realiza una captura de pantalla de un elemento de IU o una aplicación especificados y la guarda en un archivo, identificado por una cadena del Repositorio de objetos, junto con otras configuraciones.

TakeScreenhot(
    string target,
    TakeScreenshotOptions takeScreenshotOptions)

target Cadena

El destino desde el que tomar una captura de pantalla, identificado por una cadena del Repositorio de objetos. Deje null para tomar una captura de pantalla de todo el escritorio.

takeScreenshotOptions TakeScreenshotOptions

Opciones adicionales para personalizar la captura de pantalla. Puedes elegir personalizar:

• TargetOptions:
  • Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la API antes de que se produzca el error SelectorNotFoundException . El valor predeterminado es 30 segundos.
  • RetrasoDespués : tiempo de retraso (en segundos) después de ejecutar la API. La cantidad de tiempo predeterminada es de 0,3 segundos (300 milisegundos).
  • RetrasoAntes : tiempo de retraso (en segundos) antes de que la API comience a realizar cualquier operación. La cantidad de tiempo predeterminada es de 0,2 segundos (200 milisegundos).
• FileName : el nombre del archivo que quieres guardar.

TakeScreenshot(String, String)

Realiza una captura de pantalla de un elemento de IU o una aplicación especificados y la guarda en un archivo, identificado por una cadena del Repositorio de objetos, junto con otras configuraciones.

TakeScreenhot(
    string target,
    string fileName)

target Cadena

El destino desde el que tomar una captura de pantalla, identificado por una cadena del Repositorio de objetos. Deje null para tomar una captura de pantalla de todo el escritorio.

Nombre de archivo Cadena

El nombre del archivo que desea guardar.

TakeScreenshot(RuntimeTarget, TakeScreenshotOptions)

Realiza una captura de pantalla de un elemento de IU o una aplicación especificados y la guarda en un archivo, identificado por una instancia de tiempo de ejecución de un elemento del Repositorio de objetos, junto con otras configuraciones.

TakeScreenhot(
    RuntimeTarget target,
    TakeScreenshotOptions takeScreenshotOptions)

target RuntimeTarget

El destino desde el que tomar una captura de pantalla, identificado por una instancia de tiempo de ejecución de un elemento del Repositorio de objetos. Deje null para tomar una captura de pantalla de todo el escritorio.

takeScreenshotOptions TakeScreenshotOptions

Opciones adicionales para personalizar la captura de pantalla. Puedes elegir personalizar:

• TargetOptions:
  • Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la API antes de que se produzca el error SelectorNotFoundException . El valor predeterminado es 30 segundos.
  • RetrasoDespués : tiempo de retraso (en segundos) después de ejecutar la API. La cantidad de tiempo predeterminada es de 0,3 segundos (300 milisegundos).
  • RetrasoAntes : tiempo de retraso (en segundos) antes de que la API comience a realizar cualquier operación. La cantidad de tiempo predeterminada es de 0,2 segundos (200 milisegundos).
• FileName : el nombre del archivo que quieres guardar.

TakeScreenshot(TargetAnchorableModel, TakeScreenshotOptions)

Realiza una captura de pantalla de un elemento de IU o aplicación especificados y la guarda en un archivo, identificado por el objeto TargetAnchorableModel , junto con otras configuraciones.

TakeScreenhot(
    TargetAnchorableModel target,
    TakeScreenshotOptions takeScreenshotOptions)

target TargetAnchorableModel

El destino desde el que tomar una captura de pantalla, identificado por el objeto TargetAnchorableModel . Deje null para tomar una captura de pantalla de todo el escritorio.

takeScreenshotOptions TakeScreenshotOptions

Opciones adicionales para personalizar la captura de pantalla. Puedes elegir personalizar:

• TargetOptions:
  • Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la API antes de que se produzca el error SelectorNotFoundException . El valor predeterminado es 30 segundos.
  • RetrasoDespués : tiempo de retraso (en segundos) después de ejecutar la API. La cantidad de tiempo predeterminada es de 0,3 segundos (300 milisegundos).
  • RetrasoAntes : tiempo de retraso (en segundos) antes de que la API comience a realizar cualquier operación. La cantidad de tiempo predeterminada es de 0,2 segundos (200 milisegundos).
• FileName : el nombre del archivo que quieres guardar.

TakeScreenshot(TargetAnchorableModel, String)

Realiza una captura de pantalla de un elemento de la IU o una aplicación especificados y la guarda en un archivo, identificado por el objeto TargetAnchorableModel , al tiempo que especifica el nombre del archivo.

TakeScreenhot(
    TargetAnchorableModel target, 
    string fileName)

target TargetAnchorableModel

El destino desde el que tomar una captura de pantalla, identificado por el objeto TargetAnchorableModel . Deje null para tomar una captura de pantalla de todo el escritorio.

Nombre de archivo Cadena

El nombre del archivo que desea guardar.

Ejemplo de código

Aquí hay un breve recorrido de una implementación de código de muestra.

Esta línea de código establece la ruta del archivo donde se guarda la captura de pantalla.

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

Este comando se adjunta a una pantalla de una aplicación ya abierta.

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

La API TakeScreenshot se invoca aquí, capturando la imagen del elemento recién especificado en tu pantalla y posteriormente guardándola en la ruta de archivo definida.

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

Comprueba si el archivo de captura de pantalla existe en la filePath dada.

var fileExists = system.FileExists(filePath);

Finalmente, la declaración verifica que el archivo de captura de pantalla se ha guardado correctamente en el filePath especificado.

testing.VerifyAreEqual(fileExists, true);

Añadir opciones

Puedes añadir opciones en tu código de dos maneras.

Una forma de añadir opciones es utilizar la sobrecarga correcta. Para ello, pulsa Ctrl + Space y aparece IntelliSense, lo que te permite navegar y seleccionar tu sobrecarga preferida.Puedes decidir seleccionar la sobrecarga donde tienes los parámetros configurados con antelación. Los parámetros opcionales se indican dentro de corchetes.

Si deseas inicializar una única configuración como windowResize, puedes utilizar esta sintaxis:

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

Otra forma de añadir opciones es utilizar una sobrecarga de opciones común, como Attach y emparejarla con la clase Options.Esto ofrece un poco más de flexibilidad en la personalización de tus parámetros.