SVG SHOW ELEMENT
SVG SHOW ELEMENT ( {* ;} objetoImagem ; id {; margem} )
Parâmetro | Tipo | Descrição | |
---|---|---|---|
* | Operador | → | Se especificado, objetoImagem é um nome de objeto (string). Se omitido, objetoImagem é uma variável |
objetoPicture | Picture | → | Nome de objeto (se * for especificado) ou variável ou campo (se * for otimido) |
id | Text | → | Atributo ID do elemento a exibir |
margem | Integer | → | Margem de visbilidade (em pixels por padrão) |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando SVG SHOW ELEMENT move o documento SVG objetoImagem para mostrar o elemento cujo atributo "id" é especificado pelo parâmetro id.
Se passa o parâmetro opcional *, indica que o parâmetro objetoImagem é um nome de objeto (string). Neste caso, o comando é aplicado a imagem renderizada anexa ao objeto. Se não passar este parâmetro, indica que o parâmetro objetoImagem é um campo ou uma variável e se passar uma referência de variável (variável objeto unicamente) ou de campo ao invés de uma string. Neste caso, o comando se aplica as imagens renderizadas de todos os objetos que utilizam a variável ou o campo (mas não a imagem renderizada inicial).
O comando move o documento SVG para que todo o objeto, cujos limites estão definidos por seu retângulo de delimitação, seja visível. O parâmetro margem é utilizado para configurar a amplitude do movimento ao especificar a distância que deve separar o objeto que é mostrado desde as bordas do documento. Em outras palavras, o retângulo aumentará em margem píxels de largura e de altura. Por padrão, o valor de deslocamento é de 4 píxeles.
Este comando apenas tem efeito em modo de visualização "top left" (com barras de rolagem).
Se este comando não for executado no contexto de um formulário ou se for passado um objetoImagem inválido, a variável OK toma o valor 0. Se o comando for executado corretamente, toma o valor 1.