SVG Find element IDs by rect
SVG Find element IDs by rect ( {* ;} objetoImagem ; x ; y ; largura ; alto ; arrIDs ) : Boolean
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | → | Se especificado, objetoImagem é um nome de objeto (string). Se omitido, objetoImagem é uma variável |
| objetoPicture | Picture | → | Nome do objeto (se * for especificado) ou Campo ou variável (se * for omitido) |
| x | Integer | → | Coordenada horizontal da esquina esquerda superior do retângulo de seleção |
| y | Integer | → | Coordenada vertical da esquina superior esquerda do retângulo de seleção |
| largura | Integer | → | Largura da seleção retangular |
| alto | Integer | → | Altura da seleção retangular |
| arrIDs | Text array | ← | IDs dos elementos cujas molduras do retângulo intersecciona com o retângulo de seleção |
| Resultado | Boolean | ← | True = ao menos um elemento é encontrado |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando SVG Find element IDs by rect preenche o array texto arrIDs com os IDs (atributo "id" ou "xml:id") dos elementos XML cujo retângulo circundante está em intersecção com o retângulo de seleção na localização definida pelos parâmetros x e y.
O comando retorna True se for encontrado ao menos um elemento (em outras palavras se o array arrIDs não estiver vazio) e do contrário retorna False.
Este comando permite administrar interfaces gráficas interativas.
Se passa o parâmetro opcional *, indica que o parâmetro objetoImagem é um nome de objeto (string). Se não passar este parâmetro, indica que o parâmetro objetoImagem é um campo ou uma variável. Neste caso, passe uma referência de campo ou variável (campo ou variável objeto unicamente) ao invés de uma string.
Se trabalha com um campo ou variável imagem, o comando utiliza a imagem de origen, correspondente a fonte de dados. Entretanto, se trabalha com um objeto de formulário, o comando utiliza a imagem atual, que pode ser modificada através do comando SVG SET ATTRIBUTE e que é conservado com as propriedades do objeto de formulário.
As coordenadas passadas nos parâmetros x e y devem expressos em píxels em relação com a esquina superior esquerda da imagem (0,0). Pode utilizar os valores devolvidos pelas Variávels de sistema MouseX e MouseY. Estas variáveis são atualizadas nos eventos de formulário On Clicked e On Double Clicked assim como nos eventos de formulário On Mouse Enter e On Mouse Enter e On Mouse Move.
Nota: no sistema de coordenadas das imagens, [x;y] sempre especifica o mesmo ponto, sem importar o formato de visualização da imagem, exceto pelo formato "Replicado".
Todos os elementos cujo retângulo circundante está em intersecção com o retângulo de seleção são considerados, mesmo os que estão em outros elementos.