Valores calculados y lógica condicional
El cuadro de diálogo Constructor de expresiones puede utilizarse para crear lógica condicional, valores calculados, mensajes de error o para simular una base de datos. Este diálogo se abre cuando quieres añadir una condición a un evento o cuando quieres crear una acción de establecer valor con un valor calculado. La parte superior del diálogo muestra la expresión o condición que se está construyendo. Si se está construyendo una condición, la expresión estará entre dos corchetes y precedida de la palabra «cuando». Es una ayuda visual para resaltar que el resultado de cualquier expresión que se construya ahí, tiene que resolverse en verdadero o falso. No un número ni un texto. Además de definir condiciones, el cuadro de diálogo Constructor de expresiones también se puede utilizar para definir valores calculados para los siguientes tipos de acciones de evento: Establecer Valor, Girar, Redimensionar y Mover.
Para utilizar ese cuadro de diálogo para crear una condición, haz clic en el enlace «Añadir condición» que aparece en la paleta Eventos tras crear un evento.
Visión general del Constructor de expresiones
- La expresión: aquí es donde puedes construir una expresión mediante una combinación de valores y funciones.
- Funciones: arrastra desde esta lista de funciones hasta el área de la parte superior para añadirla a tu expresión. Las funciones pueden manipular distintos valores o resultados de otras funciones para obtener un valor diferente. Por ejemplo, una función de suma puede tomar dos números y devolver la suma de ambos.
- Constantes: son un conjunto de valores calculados que se pueden utilizar en las expresiones. Por ejemplo, una constante te da el tamaño actual de la ventana en el momento en que se evalúa la expresión.
- Pantalla: muestra el contenido de la pantalla actual. Puedes arrastrar cualquier elemento de la pantalla a la expresión y, una vez en la expresión, utilizar distintos tipos de propiedades de ese elemento como valores en la expresión.
- Variables: enumera todas las variables del prototipo. Las variables se pueden arrastrar a la expresión y utilizarán el valor actual de esa variable en el momento en que se evalúe la expresión.
- Maestros de Datos: enumera los Maestros de Datos y los atributos de ese prototipo. Ambos pueden utilizarse en expresiones, especialmente con algunas funciones especiales como «Filtro».
Ahora vamos a entrar en los detalles de cada una de esas secciones.
Funciones del constructor de expresiones
Las funciones se agrupan por el tipo de valor que devuelven. Están organizadas en «Número», «Texto», «Lógica» (es decir, verdadero/falso) y «Datos».
Número
Las funciones de este grupo devolverán un número como valor.
- Más: Toma dos números y devuelve el resultado de sumarlos.
- Menos: Toma dos números y devuelve el resultado de restar el segundo del primero
- Multiplicar: Toma dos números y devuelve el resultado de multiplicarlos.
- División: Toma dos números y devuelve el resultado de dividir el primero entre el segundo.
- Máx: Devuelve el mayor de dos números
- Mín: Devuelve el menor de dos números
- Promedio: Devuelve el valor medio de dos números
- Absoluto: Devuelve un valor negativo como positivo.
- Redondear: Redondea un número al número de decimales especificado en el segundo espacio
- Porcentaje: Devuelve el porcentaje del primer número respecto al segundo
- Sqrt: Devuelve la raíz cuadrada del número introducido.
- Mod: Devuelve el resto tras dividir dos números.
- Contar: Devuelve el número de caracteres de un texto.
- Índice de: Devuelve un número que es la posición del segundo texto dentro del primero. Si el segundo texto no se encuentra en el primero, devolverá -1
- Recuento (recuento de datos): Devuelve el número de instancias de un valor incluidas en un conjunto de datos.
- Suma: La suma de los valores de un conjunto de datos.
- Promedio: Determina el valor medio de un conjunto de datos
- Máx: Determina el mayor valor numérico de un conjunto de datos
- Mín: Determina el valor numérico más pequeño de un conjunto de datos
- Suelo: Redondea un número decimal hacia abajo
- Techo: Redondea un número decimal hacia arriba
Texto
Estas funciones devuelven un texto como combinación de otros textos u otros criterios.
- Concat (Concatenar): Combina dos textos en uno solo.
- Subcadena: Extrae un fragmento de un texto dadas dos posiciones. El primer espacio es el texto, el segundo es la posición inicial y el tercero es la posición final.
- Mayúsculas: Convierte el texto a mayúsculas
- Minúsculas: Convierte el texto a minúsculas
- Primera mayúscula: Pone en mayúscula el primer carácter
- Seleccionar: Dado un registro del Maestro de datos, devuelve el valor de uno de los atributos de ese registro. Si el primer parámetro contiene una colección de registros, devolverá todos los valores del atributo en esos registros separados por comas.
- El primer espacio representa el registro a seleccionar (una fila de un Maestro de datos, una fila almacenada en una Variable o una fila de una Lista de datos o Cuadrícula de datos).
- El segundo espacio define el atributo del Maestro de Datos que hay que seleccionar.
- Seleccionar distinto: Igual que «Seleccionar», pero si el resultado es una lista de valores, eliminará los duplicados.
Lógica
Devuelven verdadero o falso dados dos valores. Se utilizan principalmente para construir condiciones. Funcionan con números, textos y muchos otros tipos de valores.
- Iguales: Devuelve verdadero si ambos valores son iguales.
- No es igual: Devuelve verdadero si los valores son diferentes.
- Mayor: Devuelve verdadero si el valor de la izquierda es mayor que el de la derecha.
- Menor: Devuelve verdadero si el valor de la izquierda es menor que el de la derecha
- Mayor o igual: Devuelve verdadero si el valor del número de la izquierda es mayor o igual que el número de la derecha
- Menor o igual: Devuelve verdadero si el valor del número de la izquierda es menor o igual que el número de la derecha
- Y: Devuelve «verdadero» si todos los términos de una condición o valor son verdaderos
- O: Devuelve «verdadero» si algún término es verdadero
- No: Devuelve «verdadero» si algún término no es verdadero
- O excluyente: Devuelve «verdadero» sólo si uno de los términos es verdadero
- Expresión regular: Comprueba si un valor coincide con una expresión regular
- Tiene: Devuelve verdadero si el texto del segundo valor está presente en el texto del primer valor.
- Intersección: Determina si dos elementos se tocan
- Contiene: Determina si un elemento contiene a otro
Datos
Las funciones de datos se refieren a los datos de los Maestros de datos, las Cuadrículas de datos y las Listas de datos, así como a otros elementos de la UI que contienen datos, como las Listas de selección:
- Filtro: Función de datos que devuelve una lista de filas o registros según una condición de filtro.
- El primer espacio representa los datos a seleccionar (un Maestro de datos, una Variable, una Lista de datos o una Cuadrícula de datos).
- El segundo espacio es la condición del filtro. Especifica los registros que deben incluirse en el filtro utilizando funciones lógicas o texto.
- Filtrar distintos: Busca y filtra los valores duplicados de un conjunto de datos.
- Sumar (datos más): Combina dos conjuntos de datos.
- Eliminar (datos menos): Elimina el segundo conjunto de datos del primero.
- Ordenar: Esta función devuelve una lista de datos ordenados. Aparece un desplegable para elegir si se ordenan los datos de forma ascendente o descendente. En la expresión aparecen dos espacios de datos.
- El primero representa un conjunto de datos que hay que ordenar (por ejemplo, una fila de la Lista de datos).
- El segundo representa los datos por los que se ordenará el primero (por ejemplo, un campo Maestro de datos)
Constantes en el constructor de expresiones
Las constantes se dividen en dos categorías: Constantes y Expresiones Regulares.
Constantes
Las constantes independientes, como un texto, la fecha y la hora, las propiedades de la pantalla y la posición del cursor del ratón, pueden utilizarse para definir condiciones y crear valores.
- Texto: Introduce cualquier (y un número ilimitado de) caracteres
- Fecha: Muestra un selector de fecha
- Fecha del sistema: La fecha real en el momento de la simulación en que se está evaluando esa expresión
- Tiempo del sistema: El tiempo real en el momento de la simulación en que se está evaluando esa expresión
- Aleatorio: Genera un número aleatorio entre 0 y 1 (con decimales, como 0,97977 por ejemplo)
- Anchura de la ventana: La anchura de la pantalla en el momento en que se evalúa esa expresión
- Altura de la ventana: La altura de la pantalla en el momento en que se evalúa esa expresión
- Desplazamiento X de la ventana: La posición en píxeles de la barra de desplazamiento horizontal en cada momento
- Desplazamiento de la ventana Y: La posición en píxeles de la barra de desplazamiento vertical en cada momento
- Cursor X: La coordenada X del cursor en un momento dado
- Cursor Y: La coordenada Y del cursor en un momento dado
Expresiones regulares
Las expresiones regulares se utilizan para garantizar que los valores cumplen «reglas» (por ejemplo, para garantizar que un código postal es correcto en un formulario de registro). Deben utilizarse en combinación con la función «Expresión regular» situada en la sección «Lógica».
- Número: Describe un patrón para emparejar números, incluso con decimales (separados por ‘.’ o ‘.’)
- Correo electrónico: Describe un patrón para que coincida con las direcciones de correo electrónico (debe contener un nombre de usuario, «@», un servidor válido y «.com»)
- Porcentaje: Describe un patrón para emparejar porcentajes, con o sin decimales de hasta dos decimales
- Dinero: Describe un patrón para los números que representan dinero. Los puntos decimales y los signos de moneda son opcionales
- Código postal: Describe un patrón para hacer coincidir los códigos postales
- Tarjeta de crédito: Describe un patrón para emparejar números que sean tarjetas de crédito
- Teléfono: Describe un patrón que coincida con cualquier número entre seis y 10 dígitos (con o sin espacios y/o guiones)
- URL: Describe un patrón para hacer coincidir direcciones web
Opciones del elemento UI en el constructor de expresiones
Arrastra y suelta elementos UI de la pantalla actual a la expresión para construir una condición o un valor:
A continuación, elige qué atributo del elemento se va a utilizar en la expresión. Elige entre las siguientes opciones:
- Valor: El valor seleccionado de un elemento en la pantalla actual. Casi todos los widgets incluirán esta opción
- Pos.X relativa: La coordenada X de la posición del elemento seleccionado respecto a su contenedor padre más cercano
- Pos.X absoluta: La coordenada X de la posición del elemento seleccionado relativa a la pantalla
- Pos.Y relativa: La coordenada Y de la posición del elemento seleccionado respecto a su contenedor padre más cercano
- Pos.Y absoluta: La coordenada Y de la posición del elemento seleccionado relativa a la pantalla
- Anchura: La anchura del elemento en píxeles
- Altura: La altura del elemento en píxeles
- Ángulo: El ángulo de rotación del elemento en grados
- Es visible: Visible sólo si el elemento es visible
- Área: Las medidas de un elemento (ver más arriba Funciones de área)
Variables en el constructor de expresiones
También puedes arrastrar y soltar variables a la expresión, y utilizarlas para crear condiciones avanzadas o valores que puedan compartirse entre distintas pantallas de un prototipo.
Puedes obtener más información sobre el uso de variables en tus prototipos aquí.
Maestros de datos en el constructor de expresiones
Arrastra y suelta maestros de datos enteros, o campos de maestros de datos en la expresión para crear filtros, seleccionar registros específicos y otras operaciones con maestros de datos.
Más información sobre el uso de datos en Justinmind aquí.