4D v14

SVG_New_text

Inicio

 
4D v14
SVG_New_text

SVG_New_text 


 

SVG_New_text ( objetoSVGPadre ; texto {; x {; y {; fuente | estiloFuente {; talla {; estilo {; alineación {; color {; rotacion {; interlineado {; estiramiento}}}}}}}}}} ) -> Resultado 
Parámetro Tipo   Descripción
objetoSVGPadre  SVG_Ref in Referencia del elemento padre
texto  Texto in Texto a insertar
Real in Coordenada en el eje X
Real in Coordenada en el eje Y
fuente | estiloFuente  Texto in Nombre de la fuente o definición de estilo
talla  Entero largo in Tamaño de los caracteres en puntos
estilo  Entero largo in Estilo de los caracteres
alineación  Entero largo in Alineación
color  Cadena in Color del texto
rotacion  Real in Angulo de rotación del texto
interlineado  Real in Espacio entre líneas en puntos
estiramiento  Real in Factor de estiramiento horizontal
Resultado  SVG_Ref in Referencia del objeto texto SVG

El comando SVG_New_text inserta el texto en el contenedor SVG designado por objetoSVGPadre y devuelve su referencia. Si objetoSVGPadre no es un documento SVG, se genera un error.

Los parámetros opcionales x e y  permiten especificar la posición en el eje X e Y de la esquina superior del primer carácter del texto. Este punto está situado de manera diferente según el valor de la alineación: a la izquierda para una alineación a la izquierda, a la derecha para una alineación a la derecha o en el centro cuando el texto está centrado.

El comando SVG_New_text acepta dos sintaxis diferentes para la definición de los caracteres:

  • Puede pasar diferentes valores en los parámetros fuente, talla, estilo y alineacións: fuente y talla permiten especificar la fuente y el tamaño en puntos a utilizar. Cuando  no se pasan estos parámetros, el texto se escribirá en Times New Roman 12 pts.
    El parámetro opcional estilo da el estilo de caracteres a utilizar. En este parámetro, debe pasar uno de los siguientes estilos o una combinación de varios de estos valores (o también puede utilizar las constantes 4D correspondientes en el tema Estilos de fuente):
    0 = Normal
    1 = Negrita
    2 = Itálica
    4 = Subrayado
    8 = Tachado
    El parámetro opcional alineacion permite especificar el tipo de alineación a aplicar al texto dibujado. Puede pasar uno de los siguientes valores:
    2 = Alineado a la izquierda
    3 = Centrado
    4 = Alineación a la derecha

    El parámetro opcional color contiene el nombre del color de la fuente. (Para más información sobre los colores, consulte la sección Colores y degrades).
    El parámetro opcional rotacion permite precisar la rotación a aplicar al texto.
    El parámetro opcional interlineado permite especificar el valor del interlineado si el texto tiene más de una línea. Valor por defecto = 1.
    El parámetro opcional estiramiento permite aplicar un factor de estiramiento horizontal (valor > 1) o de condensación (valor entre 0 y 1) al texto.

  • O puede pasar una definición de estilo en el parámetro defEstilo (en lugar del parámetro fuente) y luego omite los siguientes parámetros. Por ejemplo, puede pasar:
     SVG_New_textArea($Dom_svg;"Hola mundo";x;y;vWidth;vHeight;style_definition)

    ... donde el parámetro style_definition contiene una definición de estilo completa. Si pasa, por ejemplo, "{font-size:48px;fill:red;}", esta definición se añade como un atributo de estilo de esta forma:
    style="font-size:48px;fill:red;"

    En este caso, los parámetros adicionales se ignoran.

Texto simple utilizando las propiedades de texto por defecto:

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

Texto en azul, itálica, subrayado y alineado a la derecha:

 $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;Italic+Underline;Align right;"blue")

Texto vertical:

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

Texto condensado o expandido:

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

 
PROPIEDADES 

Producto: 4D
Tema: Texto
Número 65958

 
HISTORIA 

Creado por: Composant 4D SVG v11.3
Modificado: 4D v13

 
VER TAMBIÉN 

SVG_New_textArea
SVG_New_tspan
SVG_New_vertical_text

 
ARTICLE USAGE

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

Inherited from : SVG_New_text ( 4D v12)