Saltar al contenido principal

Variables

Una variable es un valor guardado con un nombre. Un paso la guarda; los pasos posteriores la usan escribiendo $ y el nombre en un campo, o eligiéndola en Guardado por pasos anteriores en el menú de valores (Parámetros de los pasos).

Guardar el resultado de un paso​

Complete Guardar resultado como en un paso para conservar lo que devuelve. Es la forma habitual de obtener un valor: la ventana que encontró un paso, el texto que leyó, la respuesta que alguien eligió.

1Texto del portapapeles→ $copiadoClipboardGetText
2Mostrar un cuadro de mensaje$copiado, Texto copiado, OK, InformationUIShowMessageBox

El primer paso lee el portapapeles y guarda el texto como copiado. El segundo lo muestra en un cuadro de mensaje.

Asignar una variable​

El chip Asignar variable agrega un paso que guarda un valor que usted escribe. Tiene tres campos:

CampoQué contiene
VariableEl nombre. Un paso nuevo recibe un nombre libre, como value o value2.
ValorEl valor, $ y el nombre de otra variable para copiar esa variable, o una lectura del menú de valores (Parámetros de los pasos), como Texto del portapapeles.
TipoTexto, Número entero, Número o Verdadero o falso. Se oculta mientras Valor contiene una lectura.

El tipo es el que usted elige, no el que parece tener el valor: con Texto, 42 es el texto "42", no el número 42. El texto puede estar vacío; los demás tipos necesitan un valor, que se comprueba como en cualquier campo (Parámetros de los pasos).

Una lectura guarda lo que lee cuando el paso se ejecuta, con el tipo propio de esa lectura, así que no hay Tipo que elegir. Escribir el nombre de script de la lectura con paréntesis vacíos, como ClipboardGetText(), es lo mismo que elegirla, sea cual sea el tipo. Un valor Texto que es una llamada a una función integrada con algo entre sus paréntesis, como WindowGetTitle($w), se guarda como esos caracteres y no se ejecuta; el formulario lo indica. Para conservar el resultado de esa llamada, use en su lugar Guardar resultado como en el paso de esa función integrada.

Asignar una variable que ya existe reemplaza su valor.

Los tipos de valor​

Cada valor tiene uno de estos tipos. Las palabras del editor y las de la referencia de scripts:

En el editorEn la referencia de scriptsEjemplos
TextoTextNotepad, un texto vacío
Número enteroInteger0, -12, 0xB3, VirtualKey.F5
NúmeroReal0.5, 2.0
Verdadero o falsoBoolactivado / desactivado, true / false
una ventanaWindowVentana de destino, una ventana que encontró un paso

Una ventana no se puede escribir; viene del menú de valores o del resultado de un paso. Cómo cuenta cada tipo como verdadero o falso en una condición se explica en Tipos de valor.

Nombres​

Un nombre de variable:

  • usa letras, dígitos y _, y no empieza con un dígito;
  • no es if, else, for, true ni false;
  • distingue mayúsculas de minúsculas: Window y window son dos variables.

Un $ que escriba al principio de un nombre se descarta, así que $count y count nombran la misma variable.

Reglas que conviene saber​

  • El orden importa. Una variable existe desde el paso que la guarda en adelante. El editor no comprueba que una variable se guarde antes de usarse, ni que al mover pasos el paso que la guarda quede encima. Una variable que nunca se guardó se lee como el número entero 0.
  • Las variables duran una ejecución. Cada vez que la acción se ejecuta, empieza sin variables. Para conservar un valor entre ejecuciones y reinicios, use los pasos Conservar valor entre reinicios y Leer valor conservado (de Las N funciones integradas…; consulte Cómo se ejecutan los scripts).
  • Un snippet tiene sus propias variables. Un snippet llamado desde una acción no puede ver las variables de la acción, y la acción no puede ver las del snippet.
  • No hay aritmética. Un campo acepta un valor o una variable, nunca un cálculo como $count + 1. Para eso, use Script (De Pasos a Script).