4D v14

SVG_New_text

Accueil

 
4D v14
SVG_New_text

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

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.

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

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

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

Texte vertical :

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

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)

 
PROPRIÉTÉS 

Produit : 4D
Thème : Texte
Numéro : 65958
Nom intl. : SVG_New_text

 
HISTORIQUE 

Créé : Composant 4D SVG v11.3
Modifié : 4D v13

 
VOIR AUSSI  

SVG_New_textArea
SVG_New_tspan
SVG_New_vertical_text

 
UTILISATION DE L'ARTICLE

4D SVG ( 4D v13)
4D SVG ( 4D v14)

Hérité de : SVG_New_text ( 4D v12)