4D v16.3

SVG Find element IDs by rect

Página Inicial

 
4D v16.3
SVG
SVG Find element IDs by rect

SVG Find element IDs by rect 


 

SVG Find element IDs by rect ( {* ;} objetoImagem ; x ; y ; largura ; alto ; arrIDs ) -> Resultado 
Parâmetro Tipo   Descrição
Operador in Se especificado, objetoImagem é um nome de objeto (string). Se omitido, objetoImagem é uma variável
objetoImagem  Imagem in Nome do objeto (se * for especificado) ou Campo ou variável (se * for omitido)
Inteiro longo in Coordenada horizontal da esquina esquerda superior do retângulo de seleção
Inteiro longo in Coordenada vertical da esquina superior esquerda do retângulo de seleção
largura  Inteiro longo in Largura da seleção retangular
alto  Inteiro longo in Altura da seleção retangular
arrIDs  Array texto in IDs dos elementos cujas molduras do retângulo intersecciona com o retângulo de seleção
Resultado  Booleano in True = ao menos um elemento é encontrado

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 xy  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

 
PROPRIEDADES 

Produto: 4D
Tema: SVG
Número 1109

 
HISTÓRIA 

Criado por: 4D v12

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)