SVG_New_text

4D - Documentation   Français   English   German   Composant 4D SVG, Commandes par thèmes   4D SVG, Index   Retour   Précédent   Suivant

version 11.3


SVG_New_text (objetSVGParent; texte{; x{; y{; police{; taille{; style{; alignement{; couleur{; rotation{; interligne{; étirement}}}}}}}}}}) Ref_SVG

ParamètreTypeDescription
objetSVGParentRef_SVGRéférence de l'élément parent
texteTexteTexte à insérer
xNumériqueCoordonnée sur l'axe x
yNumériqueCoordonnée sur l'axe y
policeChaîneNom de la police
tailleEntierTaille des caractères en points
styleEntierStyle des caractères
alignementEntierAlignement
couleurChaîneCouleur du texte
rotationNumériqueAngle de rotation du texte
interligneNumériqueInterlignage en point
étirementNumériqueFacteur d'étirement horizontal
RésultatRef_SVGRé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 <1) au texte.

Exemples

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

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

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

3. Texte vertical :

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

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)

Référence

SVG_New_textArea, SVG_New_tspan, SVG_New_vertical_text.


4D - Documentation   Français   English   German   Composant 4D SVG, Commandes par thèmes   4D SVG, Index   Retour   Précédent   Suivant