SVG_New_group

4D - Documentation   Français   English   German   Composant 4D SVG, Commandes par thèmes   4D SVG, Index   Retour   Précédent   Suivant

version 11.3


SVG_New_group (objetSVGParent{; id{; url{; cible}}}) Ref_SVG

ParamètreTypeDescription
objetSVGParentRef_SVGRéférence de l'élément parent
idChaîneNom du groupe
urlChaîneLien externe
cibleChaîneCible du lien
RésultatRef_SVGRé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 document SVG, 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.

Exemples

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")
   SVG_New_line ($group; 100; 300; 300; 100; ""; 5)
   SVG_New_line ($group; 300; 300; 500; 100; ""; 10)
   SVG_New_line ($group; 500; 300; 700; 100; ""; 15)
   SVG_New_line ($group; 700; 300; 900; 100; ""; 20)
   SVG_New_line ($group; 900; 300; 1100; 100; ""; 25)

2. Création d'un texte cliquable :

   $SVG:=SVG_New 
   $group:=SVG_New_group ($SVG;"w3Link";"http://www.w3.org";"new")
   SVG_New_text ($group;"www.w3.org";10;10;"arial";12;Souligné ;Aligné à gauche ;"blue")

4D - Documentation   Français   English   German   Composant 4D SVG, Commandes par thèmes   4D SVG, Index   Retour   Précédent   Suivant