SDK Multiplataforma en C logo

SDK Multiplataforma en C

TextView

❮ Anterior
Siguiente ❯

Funciones

TextView*textview_create (void)
voidtextview_size (...)
voidtextview_clear (...)
uint32_ttextview_printf (...)
voidtextview_writef (...)
voidtextview_rtf (...)
voidtextview_units (...)
voidtextview_family (...)
voidtextview_fsize (...)
voidtextview_fstyle (...)
voidtextview_color (...)
voidtextview_bgcolor (...)
voidtextview_pgcolor (...)
voidtextview_halign (...)
voidtextview_lspacing (...)
voidtextview_bfspace (...)
voidtextview_afspace (...)
voidtextview_scroll_down (...)
voidtextview_editable (...)

Los TextView son vistas diseñadas para trabajar con bloques de texto enriquecido, donde pueden combinarse tipografías, tamaños y colores (Figura 1). Podemos considerarlas como la base de un editor de texto. En ¡Hola TextView! tienes un ejemplo de uso.


1. Formato de carácter

Una de las ventajas del texto enriquecido con respecto al texto plano, es la posibilidad de combinar diferentes formatos de carácter dentro del mismo párrafo (Figura 2). Los cambios se aplicarán al nuevo texto que se añada al control.

Utiliza textview_family para cambiar la tipografía.

Utiliza textview_fsize para cambiar el tamaño del carácter.

Utiliza textview_fstyle para cambiar el estilo.

Utiliza textview_color para cambiar el color del texto.

Utiliza textview_bgcolor para cambiar el color de fondo del texto.

Selección de tipografías y atributos de texto.
Figura 2: Controles típicos del formato de carácter.

2. Formato de párrafo

Se pueden establecer también atributos por párrafo (Figura 3). El carácter nueva línea '\n' se considera cierre o final del párrafo.

Utiliza textview_halign para establecer a alineación del párrafo.

Utiliza textview_lspacing para establecer la separación entre líneas (interlineado).

Utiliza textview_bfspace para indicar el espacio vertical antes del párrafo.

Utiliza textview_afspace para indicar el espacio vertical después del párrafo.

Formateo de un párrafo de texto.
Figura 3: Controles típicos del formato de párrafo.

3. Formato del documento

Por último disponemos de varios atributos que afectan a la totalidad del documento o del control.

Utiliza textview_units para establecer la unidades del texto.

Utiliza textview_pgcolor para establecer el color del fondo del control (página).


textview_create ()

Crea una vista de texto.

TextView*
textview_create(void);

Retorna

La vista de texto.


textview_size ()

Establece el tamaño por defecto de la vista.

void
textview_size(TextView *view,
              const S2Df size);
view

La vista.

size

El tamaño.

Observaciones

Corresponde al Dimensionado natural del control. Por defecto 245x144.


textview_clear ()

Borra todo el contenido de la vista.

void
textview_clear(TextView *view);
view

La vista.


textview_printf ()

Escribe texto en la vista, utilizando el formato del printf.

uint32_t
textview_printf(TextView *view,
                const char_t *format,
                ...);
1
textview_printf(view, Code: %-10s Price %5.2f\n
view

La vista.

format

Cadena con el formato tipo-printf con un número variable de parámetros.

...

Argumentos o variables del printf.

Retorna

El número de bytes escritos.


textview_writef ()

Escribe una cadena C UTF8 en la vista.

void
textview_writef(TextView *view,
                const char_t *str);
view

La vista.

str

Cadena C UTF8 terminada en carácter nulo '\0'.


textview_rtf ()

Inserta texto en el formato RTF de Microsoft.

void
textview_rtf(TextView *view,
             Stream *rtf_in);
view

La vista.

rtf_in

Stream de lectura con el contenido RTF.


textview_units ()

Establece las unidades del texto.

void
textview_units(TextView *view,
               const uint32_t units);
view

La vista.

units

Unidades ekFPIXELS ó ekFPOINTS.

Observaciones

ekFPOINTS es el valor por defecto y el utilizado normalmente por los procesadores de texto. Ver Tamaño en puntos.


textview_family ()

Establece la familia tipográfica del texto ("Arial", "Times New Roman", "Helvetica", etc).

void
textview_family(TextView *view,
                const char_t *family);
view

La vista.

family

La familia tipográfica.

Observaciones

No todas las familias estarán presentes en todas las plataformas. Utiliza font_exists_family o font_installed_families para comprobarlo.


textview_fsize ()

Establece el tamaño del texto.

void
textview_fsize(TextView *view,
               const real32_t size);
view

La vista.

size

El tamaño.

Observaciones

El valor está condicionado a las unidades establecidas en textview_units.


textview_fstyle ()

Establece el estilo del texto.

void
textview_fstyle(TextView *view,
                const uint32_t fstyle);
view

La vista.

fstyle

Combinación de ekFBOLD, ekFITALIC, ekFSTRIKEOUT, ekFUNDERLINE ekFSUBSCRIPT, ekFSUPSCRIPT. Para anular cualquier estilo previo utiliza ekFNORMAL.


textview_color ()

Establece el color del texto.

void
textview_color(TextView *view,
               const color_t color);
view

La vista.

color

El color. Utiliza kCOLOR_DEFAULT para restablecer el color por defecto.


textview_bgcolor ()

Establece el color de fondo del texto.

void
textview_bgcolor(TextView *view,
                 const color_t color);
view

La vista.

color

El color. Utiliza kCOLOR_DEFAULT para restablecer el color por defecto.


textview_pgcolor ()

Establece el color de fondo del control.

void
textview_pgcolor(TextView *view,
                 const color_t color);
view

La vista.

color

El color. Utiliza kCOLOR_DEFAULT para restablecer el color por defecto.


textview_halign ()

Establece la alineación del texto en un párrafo.

void
textview_halign(TextView *view,
                const align_t align);
view

La vista.

align

La alineación. Por defecto ekLEFT.


textview_lspacing ()

Establece el espaciado inter-lineal del párrafo.

void
textview_lspacing(TextView *view,
                  const real32_t scale);
view

La vista.

scale

Factor de escala en la altura de la fuente. 1 es el valor por defecto, 2 el doble de dicha altura, 3 el triple, etc. Valores intermedios también son válidos (pe. 1.25).


textview_bfspace ()

Establece un espacio vertical antes del párrafo.

void
textview_bfspace(TextView *view,
                 const real32_t space);
view

La vista.

space

El espacio en las unidades preestablecidas.


textview_afspace ()

Establece un espacio vertical después del párrafo.

void
textview_afspace(TextView *view,
                 const real32_t space);
view

La vista.

space

El espacio en las unidades preestablecidas.


textview_scroll_down ()

Fuerza un scroll hasta el límite inferior del contenido de la vista.

void
textview_scroll_down(TextView *view);
view

La vista.

Observaciones

Hará visible el último contenido insertado.


textview_editable ()

Establece si el texto del control es o no editable.

void
textview_editable(TextView *view,
                  const bool_t is_editable);
view

La vista.

is_editable

TRUE permitirá editar el texto. Por defecto FALSE.

❮ Anterior
Siguiente ❯