4D Doc Center : SVG_New

4D v14

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	Referencia del elemento padre
texto	Texto	Texto a insertar
x	Real	Coordenada en el eje X
y	Real	Coordenada en el eje Y
fuente \| estiloFuente	Texto	Nombre de la fuente o definición de estilo
talla	Entero largo	Tamaño de los caracteres en puntos
estilo	Entero largo	Estilo de los caracteres
alineación	Entero largo	Alineación
color	Cadena	Color del texto
rotacion	Real	Angulo de rotación del texto
interlineado	Real	Espacio entre líneas en puntos
estiramiento	Real	Factor de estiramiento horizontal
Resultado	SVG_Ref	Referencia del objeto texto SVG

Descripción

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.

Ejemplo 1

Texto simple utilizando las propiedades de texto por defecto:

 $SVG:=SVG_New

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

Ejemplo 2

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

Ejemplo 3

Texto vertical:

 $SVG:=SVG_New

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

Ejemplo 4

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)