Saltar para o conteúdo principal
Versão: Próximo

SVG Find element IDs by rect

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

ParâmetroTipoDescrição
*OperadorSe especificado, objetoImagem é um nome de objeto (string). Se omitido, objetoImagem é uma variável
objetoPicturePictureNome do objeto (se * for especificado) ou Campo ou variável (se * for omitido)
xIntegerCoordenada horizontal da esquina esquerda superior do retângulo de seleção
yIntegerCoordenada vertical da esquina superior esquerda do retângulo de seleção
larguraIntegerLargura da seleção retangular
altoIntegerAltura da seleção retangular
arrIDsText arrayIDs dos elementos cujas molduras do retângulo intersecciona com o retângulo de seleção
ResultadoBooleanTrue = 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.

Ver também

SVG Find element ID by coordinates