TextView

Funciones

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.

• Utiliza textview_create para crear una vista de texto.
• Utiliza textview_writef para insertar texto.
• Utiliza textview_printf para insertar texto con el formato de printf.
• Utiliza textview_select para posicionar el caret.
• Utiliza textview_clear para borrar todo el texto.

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 establecer la tipografía.

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

Utiliza textview_fstyle para establecer el estilo.

Utiliza textview_color para establecer el color del texto.

Utiliza textview_bgcolor para establecer el color de fondo del texto.

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.

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

4. Aplicar atributos

Los atributos del texto vistos en las secciones anteriores se aplicarán al nuevo texto añadido al control mediante las funciones textview_writef o textview_printf. Sin embargo, podemos aplicarlos al texto ya existente en el control. En ¡Hola TextEditor! tienes un ejemplo de uso.

• Utiliza textview_apply_all para aplicar los atributos a todo el texto del control.
• Utiliza textview_apply_sel para aplicar los atributos al texto seleccionado.

5. Ajuste del texto

• Utiliza textview_wrap para activar/desactivar el ajuste del texto.

Por defecto, el control ajusta automáticamente la anchura del texto, cortando las líneas cuando sea necesario. Esto se puede evitar pasando wrap=FALSE, donde cada línea ocupará su ancho natural y aparecerá una barra de scroll horizontal para poder desplazar el texto (Figura 4).

textview_create ()

Crea una vista de texto.

TextView*
textview_create(void);

Retorna

La vista de texto.

textview_OnFilter ()

Establece un manejador para filtrar el texto mientras se edita.

void
textview_OnFilter(TextView *view,
                  Listener *listener);

Observaciones

Funciona de la misma forma que en controles Edit. Ver Filtrar textos y Eventos GUI.

textview_OnFocus ()

Establece un manejador para el foco del teclado.

void
textview_OnFocus(TextView *view,
                 Listener *listener);

Observaciones

Ver Eventos GUI.

textview_size ()

Establece el tamaño por defecto de la vista.

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

Observaciones

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

textview_clear ()

Borra todo el contenido de la vista.

void
textview_clear(TextView *view);

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", code, price);

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

textview_rtf ()

Inserta texto en el formato RTF de Microsoft.

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

textview_units ()

Establece las unidades del texto.

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

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

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

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

textview_color ()

Establece el color del texto.

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

textview_bgcolor ()

Establece el color de fondo del texto.

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

textview_pgcolor ()

Establece el color de fondo del control.

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

textview_halign ()

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

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

textview_lspacing ()

Establece el espaciado inter-lineal del párrafo.

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

textview_bfspace ()

Establece un espacio vertical antes del párrafo.

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

textview_afspace ()

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

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

textview_apply_all ()

Aplica los atributos de carácter y párrafo a todo el texto del control. En caso de no existir texto, se tomarán como los atributos por defecto del texto que se añada mediante el teclado.

void
textview_apply_all(TextView *view);

1
2
3
4
5

textview_family(view, "Arial");
textview_fsize(view, 16);
textview_color(view, kCOLOR_RED);
// Arial:16:Red to all text or default
textview_apply_all(view);

Observaciones

Ver Aplicar atributos.

textview_apply_sel ()

Aplica los atributos de carácter y párrafo al texto seleccionado.

void
textview_apply_sel(TextView *view);

Observaciones

Ver Aplicar atributos.

textview_scroll_visible ()

Muestra u oculta las barras de scroll.

void
textview_scroll_visible(TextView *view,
                        const bool_t horizontal,
                        const bool_t vertical);

textview_editable ()

Establece si el texto del control es o no editable.

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

textview_select ()

Selecciona texto.

void
textview_select(TextView *view,
                const int32_t start,
                const int32_t end);

Observaciones

Funciona de la misma forma que en controles Edit. Ver Selección del texto.

textview_show_select ()

Establece si se muestra u oculta la selección del texto al perder el foco del teclado.

void
textview_show_select(TextView *view,
                     const bool_t show);

Observaciones

Al perder el foco del teclado, el control mantendrá la selección del texto. Esta función solo afecta a la visibilidad de la selección.

textview_scroll_caret ()

En textos que exceden la parte visible, realiza un scroll hasta la posición del caret.

void
textview_scroll_caret(TextView *view);

textview_get_text ()

Obtiene el texto del control.

const char_t*
textview_get_text(const TextView *view);

Retorna

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

textview_copy ()

Copia al portapapeles el texto seleccionado.

void
textview_copy(const TextView *view);

Observaciones

Funciona de la misma forma que en controles Edit. Ver Operaciones con el portapapeles.

textview_cut ()

Corta el texto seleccionado, copiándolo al portapapeles.

void
textview_cut(TextView *view);

Observaciones

Funciona de la misma forma que en controles Edit. Ver Operaciones con el portapapeles.

textview_paste ()

Pega el texto del portapapeles en la posición del caret.

void
textview_paste(TextView *view);

Observaciones

Funciona de la misma forma que en controles Edit. Ver Operaciones con el portapapeles.

textview_wrap ()

Activa o desactiva el ajuste automático del texto.

void
textview_wrap(TextView *view,
              const bool_t wrap);

Observaciones

Ver Ajuste del texto.