SVG_New_group

version 11.3

SVG_New_group (parentSVGObject{; id{; url{; target}}}) SVG_Ref

The SVG_New_group command creates a group in the SVG container designated by parentSVGObject and returns its reference. If parentSVGObject is not an SVG document, an error is generated.

The group ('g' element) can be used to group together several linked graphic elements, which will inherit the properties of the group.

The optional id parameter can be used to assign a name to the group. Named groups are necessary for several purposes such as animation and reusable objects.

The optional url parameter can be used to associate an external link. Group objects are then clickable (similar to the 'a' element of HTML).

The optional target parameter specifies the name of the target where the document will open when the link is activated. The values expected are those of the HTML specification to which are added the 'new' value for opening a new window and the 'none' value which is equivalent to not processing this attribute.

Note: External links are ignored when the SVG is displayed in a picture object (variable or field) of a 4D form. Management of external references is handled by the rendering engine. Under these conditions, the result may depend on the platform and the viewing software.

1. A group of lines, all the same color:

   $SVG:=SVG_New 
   $group:=SVG_New_group ($SVG)
      `Assign a color to the group elements
   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. Clickable text:

   $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;Underline ;Align Left ;"blue")