SVG SHOW ELEMENT

4D v16.3

SVG

SVG SHOW ELEMENT


SVG SHOW ELEMENT ( {* ;} objetImage ; id {; marge} )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objetImage est un nom d'objet (chaîne) Si omis, objetImage est une variable ou un champ
objetImage	Image	Nom d’objet (si * spécifié) ou Variable ou champ (si * omis)
id	Texte	Attribut id de l’élément à visualiser
marge	Entier long	Marge de visibilité (en pixels par défaut)

Description

La commande SVG SHOW ELEMENT déplace le document SVG objetImage de façon à rendre visible l’élement dont l’attribut "id" est désigné par le paramètre id.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objetImage est un nom d’objet (une chaîne). Dans ce cas, la commande s’applique à l’image de rendu attachée à l’objet. Si vous ne passez pas le paramètre *, vous indiquez que le paramètre objetImage est une variable ou un champ. Vous ne passez alors pas une chaîne mais une référence de variable (variable objet uniquement) ou de champ. Dans ce cas, la commande s’applique aux images de rendu de tous les objets qui utilisent la variable ou le champ (mais pas à l’image de rendu initiale).

La commande déplace le document SVG de manière à ce que la totalité de l’objet, dont les limites sont définies par son rectangle englobant, soit visible. Le paramètre marge permet de configurer l’amplitude du déplacement en définissant la distance devant séparer l’objet visualisé des bords du document. Autrement dit, le rectangle englobant sera augmenté de marge pixels en largeur et en hauteur. Par défaut, la valeur de déplacement est de 4 pixels.

Cette commande n’a d’effet qu’en mode d’affichage "top left" (avec barres de défilement).

Si la commande est exécutée en-dehors du contexte d'un formulaire ou si un objetImage invalide est passé, la variable OK prend la valeur 0. Si la commande a été exécutée correctement, elle prend la valeur 1.