Saltar al contenido principal
Versión: Siguiente

SVG Find element IDs by rect

SVG Find element IDs by rect ( {* ;} objetoImagen ; x ; y ; ancho ; alto ; arrIDs ) -> Resultado

ParámetroTipoDescripción
*OperadorSi se especifica, objetoImagen es un nombre de objeto (cadena). Si se omite, objetoImagen es un campo o una variable.
objetoPicturePictureNombre del objeto (si se especifica *) o Campo o Variable (si se omite *)
xIntegerCoordenada horizontal de la esquina superior izquierda del rectángulo de selección.
yIntegerCoordinada vertical de la esquina superior izquierda del rectángulo de selección
anchoIntegerAncho del rectángulo de selección
altoIntegerAltura del rectángulo de selección
arrIDsText arrayIDs de los elementos cuyo rectángulo circundante está en intersección con el rectángulo de selección
ResultadoBooleanTrue = se encontró al menos un elemento

Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.

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.

Ver también

SVG Find element ID by coordinates