SVG_New_group

4D v16

SVG_New_group


SVG_New_group ( objetoSVGPai {; id {; url {; objetivo}}} ) -> Resultado

Parâmetro	Tipo	Descrição
objetoSVGPai	Ref_SVG	Referencia do elemento pai
id	String	Nome do grupo
url	String	Link externo
objetivo	String	Objetivo do link
Resultado	Ref_SVG	Referencia do grupo

Descrição

O comando SVG_New_group cria um grupo no recipiente SVG designado por objetoSVGPai e devolve sua referencia. Se objetoSVGPai não é um grupo ou um documento SVG válido, é gerado um erro.

O grupo (elemento "g") permite agrupar vários elementos gráficos vinculados, que irá herdar as propriedades do grupo.

O parâmetro opcional id permite atribuir um nome ao grupo. Os grupos com nome são necessários para vários propósitos, tais como a animação e os objetos reutilizáveis.

O parâmetro opcional url permite associar um link externo. Pode ser feito clique a continuação nos objetos do grupo (similar ao elemento 'a' de HTML).

O parâmetro opcional objetivo especifica o nome do objetivo no qual o documento será aberto quando se ativa o link. Os valores esperados são os da especificação HTML aos que se sumam os valores "new" para abrir em uma nova janela e 'none', que é equivalente a não processar este atributo.

Nota: Os links externos se ignoram quando o SVG é mostrado em um objeto imagem (variável ou campo) de um formulário 4D. A gestão das referencias externas é realizada pelo motor de renderização. Nestas condições, o resultado pode depender da plataforma e o software de visualização.

Exemplo 1

Criação de um grupo de linhas, todas da mesma cor:

 $SVG:=SVG_New

 $group:=SVG_New_group($SVG)

  `Atribuir uma cor aos elementos do grupo

 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)

Exemplo 2

Criação de um texto no qual possa fazer clique:

 $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")