4D Doc Center : SVG_New

4D v12

SVG_New_text


SVG_New_text ( objetSVGParent ; texte {; x {; y {; police {; 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	Chaîne	Nom de la police
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é.

Les paramètres optionnels police et taille permettent de spécifier la police et la taille, en points, à utiliser. Lorsque ces paramètres sont omis, le texte est é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 (vous pouvez également utiliser les constantes 4D correspondantes dans le thème "Alignement objet"):

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.

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)