4D Doc Center : SVG_New

4D v13

SVG_New_text


SVG_New_text ( objetSVGParent ; texte {; x {; y {; police \| stylePolice {; taille {; style {; alignement {; couleur {; rotation {; interligne {; étirement}}}}}}}}}} ) -> Résultat

Paramètre	Type	Description
objetSVGParent	Ref_SVG	Référence de l’élément parent
texte	Texte	Texte à insérer
x	Réel	Coordonnée sur l'axe x
y	Réel	Coordonnée sur l'axe y
police \| stylePolice	Texte	Nom de la police ou Définition de style
taille	Entier long	Taille des caractères en points
style	Entier long	Style des caractères
alignement	Entier long	Alignement
couleur	Chaîne	Couleur du texte
rotation	Réel	Angle de rotation du texte
interligne	Réel	Interlignage en point
étirement	Réel	Facteur d'étirement horizontal
Résultat	Ref_SVG	Référence de l'objet texte SVG

Description

La commande SVG_New_text insère le texte 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.

Les paramètres optionnels x et y permettent de préciser le positionnement sur l'axe x et sur l'axe y du coin supérieur du premier caractère du texte. Ce point est différemment situé selon la valeur de l'alignement : à gauche pour un alignement à gauche, à droite pour un alignement à droite ou au centre lorsque le texte est centré.

La commande SVG_New_text accepte deux syntaxes différentes pour la définition des caractères :

vous pouvez passer diverses valeurs dans les paramètres police, taille, style, alignement, couleur, rotation, interligne et étirement : police et taille permettent de spécifier la police et la taille, en points, à utiliser. Si ces paramètres sont omis, le texte sera écrit en Times New Roman 12 pts.
Le paramètre optionnel style précise le style de caractères à utiliser. Vous devez passer dans le paramètre style l'une des valeurs suivantes ou une combinaison de ces valeurs (vous pouvez également utiliser les constantes 4D correspondantes dans le thème Styles de caractères) :
0 = Normal
1 = Gras
2 = Italique
4 = Souligné
8 = Barré

Le paramètre optionnel alignement permet de spécifier le type d'alignement appliqué au texte dessiné. Vous devez passer une des valeurs suivantes :
2 = Aligné à gauche
3 = Centré
4 = Aligné à droite

Le paramètre optionnel couleur contient le nom de la couleur de la police. Pour plus d’informations sur les couleurs, reportez-vous au chapitre "Couleurs et dégradés".
Le paramètre optionnel rotation permet de préciser la rotation à appliquer au texte.
Le paramètre optionnel interligne permet de préciser la valeur de l'interlignage si le texte comporte plusieurs lignes. Valeur par défaut = 1.
Le paramètre optionnel étirement permet d'appliquer horizontalement un facteur d'étirement (valeur >1) ou de condensation (valeur comprise entre 0 et 1) au texte.

ou bien, vous pouvez passer une définition de style dans le paramètre défStyle (en lieu et place du paramètre police) et omettre les paramètres suivants. Vous pouvez passer par exemple :
SVG_New_text($Dom_svg;"Hello World !";x;y;style_definition)

... où le paramètre style_definition contient une définition de style complète. Si vous passez par exemple "{font-size:48px;fill:red;}", cette définition sera ajoutée en tant qu’attribut de style sous la forme :
```
style="font-size:48px;fill:red;"
```
Dans ce cas, les éventuels paramètres suivants sont ignorés.

Exemple 1

Texte simple utilisant les propriétés de texte par défaut :

 $SVG:=SVG_New

 $textID:=SVG_New_text($SVG;"Hello world!")

Exemple 2

Texte en bleu, italique, souligné et aligné à droite :

 $SVG:=SVG_New

 $text:="Hello world!\rBonjour le monde!\rHola Mundo!"

 $size:=48

 $font:="helvetica"

 $textID:=SVG_New_text($SVG;$text;400;10;$font;$size;Italique+Souligné;Aligné à droite;"blue")

Exemple 3

Texte vertical :

 $SVG:=SVG_New

 $textID:=SVG_New_text($SVG;$text;-250;0;"";48;-1;-1;"red";-90)

Exemple 4

Texte condensé ou étiré :

 $SVG:=SVG_New

 $textID:=SVG_New_text($SVG;"Hello world (condensed)";0;0;"";-1;-1;-1;"blue";0;1;0,8)

 $textID:=SVG_New_text($SVG;"Hello world (normal)";0;24)

 $textID:=SVG_New_text($SVG;"Hello world (stretched)";0;48;"";-1;-1;-1;"red";0;1;2)