4D Doc Center : SVG_New

Home

4D v14

Text

SVG_New_tspan


SVG_New_tspan ( parentSVGObject ; text {; x {; y {; font \| styleDef {; size {; style {; alignment {; color}}}}}}} ) -> Function result

Parameter	Type	Description
parentSVGObject	SVG_Ref	Reference of parent element
text	Text	Text to insert
x	Longint	Coordinate on X axis
y	Longint	Coordinate on Y axis
font \| styleDef	Text	Font name or Style definition
size	Integer	Size of characters in points
style	Integer	Style of characters
alignment	Integer	Alignment
color	String	Text color
Function result	SVG_Ref	Reference of SVG text object

Description

The SVG_New_tspan command creates a new element in the 'text', ‘tspan’ or 'textArea' element designated by parentSVGObject and returns its reference. If parentSVGObject is not a reference to a 'text', ‘tspan’ or 'textArea' element, an error is generated.

The different optional parameters are described with the SVG_New_text command. If certain optional parameters are omitted, their values are inherited from parent element(s).

Example 1

In a text, it is possible to create paragraphs that inherit the properties of a parent.

 $SVG:=SVG_New

  `Creates a new text that is in Arial, blue, and aligned to the left

 $textID:=SVG_New_text($SVG;"";0;0;"arial";-1;-1;Align left;"blue")

  `Nested paragraphs with indentation and changing of size and style

 $textID:=SVG_New_tspan($textID;"TITLE 1";10;10;"";24;Bold+Underline)

 $textID:=SVG_New_tspan($textID;"Title 2";20;42;"";12;Bold)

 $textID:=SVG_New_tspan($textID;"Title 3";30;60;"";10;Bold+Italic)

 $textID:=SVG_New_tspan($textID;"Title 4";40;78;"";8;Italic)

Example 2

Changing a property while remaining in the same "text" element, here the size of the text.

 $textID:=SVG_New_text($SVG;"Writing ";10;10;"arial";12)

 SVG_SET_FONT_SIZE(SVG_New_tspan($textID;"with ");14)

 SVG_SET_FONT_SIZE(SVG_New_tspan($textID;"SVG ");18)

 SVG_SET_FONT_SIZE(SVG_New_tspan($textID;"is ");24)

 SVG_SET_FONT_SIZE(SVG_New_tspan($textID;"easy ");36)