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 |
| objetPicture | Picture | → | Nom d’objet (si * spécifié) ou Variable ou champ (si * omis) |
| id | Text | → | Attribut id de l’élément à visualiser |
| marge | Integer | → | Marge de visibilité (en pixels par défaut) |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
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.