Win Screenshot

Tipo: win-screenshot · Paquete: Desktop Activities v1.0.0

Toma una captura de pantalla de la ventana completa o de un elemento concreto y la guarda en un archivo de imagen. Muy útil para dejar evidencia de lo que hizo el bot y, sobre todo, para diagnosticar fallos en ejecuciones desatendidas: una captura en el catch te muestra cómo estaba la aplicación cuando algo salió mal.

Cómo funciona

Captura el elemento del selector, o —si lo omites— la ventana completa de la sesión, y la guarda en path (.png o .jpg).

Parámetros requeridos

Parámetro	Editor	Descripción
`path`	expresión	Ruta del archivo de salida (`.png`, `.jpg`). Admite expresiones.

Parámetros opcionales

Parámetro	Editor	Descripción
`session`	sesión	Sesión de Win Attach. Si se omite, el selector debe incluir la ventana.
`selector`	selector	Elemento a capturar. Si se omite, captura toda la ventana (requiere una sesión).
`timeout`	número	Máximo en ms a esperar el elemento. Por defecto `30000`.

Ejemplo

Capturar la ventana si algo falla, para diagnóstico:

Try / Catch   errorVariable = error
 ├─ try:
 │    Win Click   selector = (botón "Procesar")
 │    Win Wait For   selector = (etiqueta "Listo")   state = visible
 └─ catch:
      Win Screenshot   session = = app   path = = "C:/evidencias/error_" + now().ToString("yyyyMMdd_HHmmss") + ".png"
      Log   level = error   message = = "Fallo al procesar: " + error

Actividades relacionadas

Try / Catch — capturar pantalla al manejar un error.
Win Get Text — leer un dato concreto en vez de una imagen.