4D Doc Center : SVG_New

4D v12

SVG_New_text


SVG_New_text ( objetoSVGPadre ; texto {; x {; y {; fuente {; 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	Cadena	Nombre de la fuente
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.

Los parámetros opcionales fuente y talla permiten especificar la fuente y el tamaño en puntos a utilizar. Cuando no se pasan estos parámetros, el texto será escrito 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:

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.

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)