SVG Find element IDs by rect
SVG Find element IDs by rect ( {* ;} objetoImagen ; x ; y ; ancho ; alto ; arrIDs ) -> Resultado
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| * | Operador | 🡒 | Si se especifica, objetoImagen es un nombre de objeto (cadena). Si se omite, objetoImagen es un campo o una variable. |
| objetoImagen | Imagen | 🡒 | Nombre del objeto (si se especifica *) o Campo o Variable (si se omite *) |
| x | Entero largo | 🡒 | Coordenada horizontal de la esquina superior izquierda del rectángulo de selección. |
| y | Entero largo | 🡒 | Coordinada vertical de la esquina superior izquierda del rectángulo de selección |
| ancho | Entero largo | 🡒 | Ancho del rectángulo de selección |
| alto | Entero largo | 🡒 | Altura del rectángulo de selección |
| arrIDs | Array texto | 🡘 | IDs de los elementos cuyo rectángulo circundante está en intersección con el rectángulo de selección |
| Resultado | Booleano | 🡐 | True = se encontró al menos un elemento |
Descripción
El comando SVG Find element IDs by rect llena el array texto arrIDs con los IDs (atributo "id" o "xml:id") de los elementos XML cuyo rectángulo circundante está en intersección con el rectángulo de selección en la ubicación definida por los parámetros x y y.
El comando devuelve True si al menos se encuentra un elemento (en otras palabras si el array arrIDs no está vacío) y de lo contrario devuelve False.
Este comando permite administrar interfaces gráficas interactivas.
Si pasa el parámetro opcional *, indica que el parámetro objetoImagen es un nombre de objeto (cadena). Si no pasa este parámetro, indica que el parámetro objetoImagen es un campo o una variable. En este caso, pase una referencia de campo o variable (campo o variable objeto únicamente) en lugar de una cadena.
Si trabaja con un campo o variable imagen, el comando utiliza la imagen de origen, correspondiente a la fuente de datos. Sin embargo, si trabaja con un objeto de formulario, el comando utiliza la imagen actual, que puede modificarse vía el comando SVG SET ATTRIBUTE y que se conserva con las propiedades del objeto de formulario.
Las coordenadas pasadas en los parámetros x y y deben expresarse en píxeles en relación con la esquina superior izquierda de la imagen (0,0). Puede utilizar los valores devueltos por las MouseX y MouseY. Estas variables son actualizadas en los eventos de formulario On Clicked y On Double Clicked como también en los eventos de formulario On Mouse Enter y On Mouse Move.
Nota: en el sistema de coordenadas de las imágenes, [x;y] siempre define el mismo punto, sin importar el formato de visualización de la imagen, excepto por el formato "Replicado".
Todos los elementos cuyo rectángulo circundante está en intersección con el rectángulo de selección son tenidos en cuenta, incluso los que están bajo otros elementos.