SVG_New_group

4D v16

SVG_New_group


SVG_New_group ( objetSVGParent {; id {; url {; cible}}} ) -> Résultat

Paramètre	Type	Description
objetSVGParent	Ref_SVG	Référence de l’élément parent
id	Chaîne	Nom du groupe
url	Chaîne	Lien externe
cible	Chaîne	Cible du lien
Résultat	Ref_SVG	Référence du groupe

Description

La commande SVG_New_group crée un groupe dans le conteneur SVG désigné par objetSVGParent et retourne sa référence. Si objetSVGParent n’est pas un groupe ou un document SVG valide, une erreur est générée.

Un groupe (élément 'g') permet de regrouper plusieurs éléments graphiques reliés, qui hériteront des propriétés du groupe.

Le paramètre optionnel id permet d'attribuer un nom au groupe. Les groupes nommés sont nécessaires pour plusieurs finalités telles que l'animation et les objets réutilisables.

Le paramètre optionnel url permet d'associer un lien externe. Les objets du groupe sont alors cliquables (analogue à l'élément 'a' du HTML).

Le paramètre optionnel cible spécifie le nom de la cible dans laquelle le document doit s'ouvrir quand le lien est activé. Les valeurs attendues sont celles du HTML auxquelles s'ajoutent la chaîne "new" pour l'ouverture dans une nouvelle fenêtre et "none" qui équivaut à ne pas traiter cet attribut.

Note : Les liens externes sont ignorés lorsque le SVG est affiché dans un objet image (variable ou champ) d'un formulaire 4D. La gestion des références externes est effectuée par le moteur de rendu. Dans ces conditions, le résultat peut dépendre de la plate-forme et du logiciel de visualisation.

Exemple 1

Création d'un groupe de lignes toutes de la même couleur :

 $SVG:=SVG_New

 $group:=SVG_New_group($SVG)

  `Attribuer une couleur aux éléments du groupe

 SVG_SET_STROKE_BRUSH($group;"firebrick")

 $newobject:=SVG_New_line($group;100;300;300;100;"";5)

 $newobject:=SVG_New_line($group;300;300;500;100;"";10)

 $newobject:=SVG_New_line($group;500;300;700;100;"";15)

 $newobject:=SVG_New_line($group;700;300;900;100;"";20)

 $newobject:=SVG_New_line($group;900;300;1100;100;"";25)

Exemple 2

Création d'un texte cliquable :

 $SVG:=SVG_New

 $group:=SVG_New_group($SVG;"w3Link";"http://www.w3.org";"new")

 $newobject:=SVG_New_text($group;"www.w3.org";10;10;"arial";12;Underline;Align left;"blue")