4D v15

SVG_New_textArea

  •  
 
4D v15
SVG_New_textArea

SVG_New_textArea 


 

SVG_New_textArea ( objetSVGParent ; texte {; x {; y {; largeur {; hauteur {; police | stylePolice {; taille {; style {; alignement}}}}}}}} ) -> Résultat 
Paramètre Type   Description
objetSVGParent  Ref_SVG in Référence de l’élément parent
texte  Texte in Texte à insérer
Entier long in Coordonnée sur l'axe x
Entier long in Coordonnée sur l'axe y
largeur  Entier long in Largeur de la zone de texte
hauteur  Entier long in Hauteur de la zone de texte
police | stylePolice  Texte in Nom de la police ou Définition de style
taille  Entier in Taille des caractères en points
style  Entier in Style des caractères
alignement  Entier in Alignement
Résultat  Ref_SVG in Référence de l'objet texte SVG

The SVG_New_textArea command inserts a text area in the SVG container designated by parentSVGObject and returns its reference. If parentSVGObject is not an SVG document, an error is generated.

The "textArea" element is recommended by the SVG tiny 1.2 standard and implemented in 4D v11 SQL beginning with version 11.3 (see http://www.w3.org/TR/SVGMobile12/text.html#TextAreaElement). This element implements a text area that, unlike the "text" element, automatically handles the line feed when the text exceeds the width requested.

Notes:

  • In the "textArea" element, <tbreak/> elements replace line returns.
  • Starting with 4D v15, the SVG_New_textArea command supports Styled Text (see example 2).

The optional x and y parameters can be used to specify the position on the X and Y axes of the top left corner of the area.

The optional textWidth and textHeight parameters specify the size of the area in the user coordinate space. If one or the other of these parameters is not provided, the text area will automatically be fitted to its contents.

The SVG_New_textArea command accepts two different syntaxes for setting characters:

  • You can pass various values in the font , size , style and alignment parameters: font and size can be used to specify the font and size, in points, to be used. When these parameters are omitted, the text will be written in Times New Roman 12 pts.
    The optional style parameter gives information about the character style used. In the style parameter, you must pass one of the following values or a combination of several of them (or you can also use the corresponding 4D constants from the Font Styles theme):

    0 = Plain
    1 = Bold
    2 = Italic
    4 = Underline
    8 = Strikethrough

    The optional alignment parameter can be used to set the type of alignment to be applied to the drawn text. You can pass one of the following values:
    1 = Align default (left)
    2 = Align left
    3 = Center
    4 = Align right
    5 = Justify
  • Or you can pass a style definition in the styleDef parameter (instead of the font parameter) and then omit the following parameters. For example, you can pass:
     SVG_New_textArea($Dom_svg;"Hello World !";x;y;vWidth;vHeight;style_definition)

    ... where the style_definition parameter contains a complete style definition. If you pass, for instance, "{font-size:48px;fill:red;}", this definition is added as a style attribute in the form:
    style="font-size:48px;fill:red;"

    In this case, any additional parameters are ignored.

 $svg:=SVG_New
  `Position a border rectangle
 $rec:=SVG_New_rect($svg;5;5;210;320;0;0;"#777";"peachpuff";3)
  `The text
 $txt:="Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed non risus. Suspendisse lectus tortor, dignissim sit amet, adipiscing nec, ultricies sed, dolor."
 $txtArea:=SVG_New_textArea($svg;$txt;10;10;200;310;"Georgia";25;Italic;5)
  `Save document
 SVG_SAVE_AS_TEXT($svg;"test.svg")

Display of multi-style text:

 C_TEXT($Dom_svg;$Dom_text;$Txt_buffer)
  //definition of multi-style text
 $Txt_buffer:="<SPAN STYLE=\"font-size:18pt\">Hello </SPAN>"+\
 "<SPAN STYLE=\"font-size:24pt;font-weight:bold;color:#D81E05\">World</SPAN>"+\
 "<SPAN STYLE=\"font-size:36pt\">!</SPAN><BR/>"+\
 "<SPAN STYLE=\"font-size:19pt;font-style:italic\">It's </SPAN>"+\
 "<SPAN STYLE=\"font-size:24pt\">Monday</SPAN>"
 $Dom_svg:=SVG_New
 
  //title
 SVG_SET_FONT_COLOR(SVG_New_text($Dom_svg;"_______ SVG_New_textArea ______";10;30;"";-1);"blue")
  //textArea
 $Dom_text:=SVG_New_textArea($Dom_svg;$Txt_buffer;50;50)
 
 SVGTool_SHOW_IN_VIEWER($Dom_svg)
 SVG_CLEAR($Dom_svg)



Voir aussi  

SVG_APPEND_TEXT_TO_TEXTAREA
SVG_New_text
SVG_New_vertical_text
SVG_SET_TEXTAREA_TEXT