4D v14.3

SVG Find element ID by coordinates

Página Inicial

 
4D v14.3
SVG
SVG Find element ID by coordinates

SVG Find element ID by coordinates 


 

SVG Find element ID by coordinates ( {* ;} objetoImagem ; X ; Y ) -> Resultado 
Parâmetro Tipo   Descrição
Operador in Se especificado, objetoImagem é um nome de objeto (string), se omitido, objetoImagem é um campo ou variável
objetoImagem  Imagem in Nome de objeto (Se * for especificado) ou Campo ou Variável (se * for omitido)
Inteiro longo in Coordenadas X em píxels
Inteiro longo in Coordenadas Y em píxels
Resultado  cadeia in ID do elemento encontrado na localização X, Y

O comando SVG Find element ID by coordinates retorna a identificação ("id" ou atributo "xml:id") do elemento XML encontrado na localização definida pelas coordenadas (x,y) na imagem SVG designada pelo parâmetro objetoImagem. Este comando pode ser utilizado particularmente para criar interfaces gráficas interativas utilizando objetos SVG.

Nota: para maior informação sobre o formato SVG, por favor consulte a seção Introdução aos comandos de XML Utilities.

Se passa o parâmetro opcional *, indique que o parâmetro pictureObject é um nome de objeto (string). Se não passa este parâmetro, indique que o parâmetro pictureObject é um campo ou variável. Neste caso, não passe uma string, e sim uma referencia de campo ou variável (campo ou variável objeto apenas).

Note que não é obrigatorio que a imagem em um formulário seja mostrada. Neste caso, a sintaxe de tipo "object name" não é válida e deve passar um nome de campo ou variável.

As coordenadas passadas nos parâmetros x e y devem estar expressadas em píxeis relativos a esquina superior esquerda da imagem (0,0). No contexto de uma imagem mostrada em um formulário, pode utilizar os valores devolvidos pelas variáveis 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 Move.

Nota: no sistema de coordenadas da imagem, MouseX e MouseY sempre especifica o mesmo ponto, independentemente do formato de visualização da imagem (excepto no caso do formato "Replicated"), mesmo quando a imagem for rolada ou receber um zoom.

O ponto a ser considerado é o primeiro ponto alcançado. Por exemplo, no seguinte caso, o comando devolverá a identificação do círculo se as coordenadas do ponto A forem passadas, e a do retângulo se as coordenadas do ponto B forem passadas:

 

Quando as coordenadas corresponderem a um objeto superposto ou composto, o comando retorna a identificação do primeiro objeto com um identificador de atributo válido, se for necessário, entre os elementos pai.

O comando retorna uma string vazia se:

  • a raiz é alcançada sem encontrar um atributo "id",
  • o ponto de coordenadas não pertence a nenhum objeto,
  • o atributo "id" é uma string vazia.

Nota: este comando não pode detectar objetos cujo valor de opacidade (atributo "fill-opacity") seja inferior a 0.01.

Se objetoImagem não contiver uma imagem SVG válida, o comando retorna uma string vazia e a variável sistema OK toma o valor 0. Do contrário, se o comando for executado corretamente, a variável sistema OK toma o valor 1.

Se objetoImagem não contiver uma imagem SVG válida, o comando retorna uma cadeia vazia e a variável sistema OK toma o valor 0. Do contrário, se o comando for executado corretamente, a variável sistema OK toma o valor 1.

 
PROPRIEDADES 

Produto: 4D
Tema: SVG
Número 1054

Este comando modifica a variável sistema OK

 
HISTÓRIA 

Criado por: 4D v11 SQL Release 3

 
VER TAMBÉM 

SVG Find element IDs by rect

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)

Inherited from : SVG Find element ID by coordinates ( 4D v11 SQL Release 6)