# Caja de texto enriquecido

Control de **edición** específico para [campos](../../../editores/asistente-de-formulas/campos) de tipo objeto texto enriquecido.

![](https://content.gitbook.com/content/hGRTr5J3e6YsZ6MYIEDz/blobs/sz0yhKCrlv69L1UPQO1w/res_343.png)

Para crearlo ejecutar la opción “caja de texto enriquecido” de la barra de controles de edición del editor de formularios, hacer un clic con el botón izquierdo del ratón dentro del área del formulario y, sin soltar el botón del ratón, arrastrarlo hacia abajo y hacia la derecha hasta obtener el tamaño deseado. Soltar el botón del ratón para finalizar la creación del control.&#x20;

## Propiedades

### Identificador

Etiqueta alfanumérica que identifica al control. Este identificador será el que se usa para referenciarlo en los [inspectores](../../../../inspectores) y en las propiedades de otros objetos.

### Nombre

Etiqueta alfanumérica que servirá como descriptor del control.

### Estilos

Podemos definir los estilos siguientes:

#### Privado

Limita el acceso del usuario final al sub-objeto desde puntos donde no se haya programado el acceso al mismo.

#### Retardo señal valueChanged

Si activamos este estilo, provocará que el envío de la señal de cambio en el valor del campo se posponga hasta finalizar la escritura, esperando para emitirla 500 milisegundos desde la última modificación realizada.

### Comentarios

Esta propiedad nos permite documentar el uso del control.

### Tipo

Muestra el tipo de control de que se trata. En este caso es **caja de texto enriquecido**, aunque podremos modificarlo. Si modificamos el tipo de control perderemos las propiedades específicas de éste.

### Ancho

Muestra la anchura en píxels del control; es posible modificar su contenido o bien escribiendo directamente un número o bien usando los microscrollers: ![](https://content.gitbook.com/content/hGRTr5J3e6YsZ6MYIEDz/blobs/4XxUafmEGACBLL7iruYp/microscrollers.jpg), que permiten aumentar/disminuir en una unidad el valor actual.

### Alto

Muestra la altura en píxels del control; es posible modificar su contenido o bien escribiendo directamente un número o bien usando los microscrollers: ![](https://content.gitbook.com/content/hGRTr5J3e6YsZ6MYIEDz/blobs/4XxUafmEGACBLL7iruYp/microscrollers.jpg), que permiten aumentar/disminuir en una unidad el valor actual.

### Posición X

Muestra la posición del control, en pixels, en el eje X (horizontal) dentro del formulario.Es posible modificar su contenido o bien escribiendo directamente un número o bien usando los microscrollers: ![](https://content.gitbook.com/content/hGRTr5J3e6YsZ6MYIEDz/blobs/4XxUafmEGACBLL7iruYp/microscrollers.jpg), que permiten aumentar/disminuir en una unidad el valor actual.

### Posición Y

Muestra la posición del control, en pixels, en el eje Y (vertical) dentro del formulario.Es posible modificar su contenido o bien escribiendo directamente un número o bien usando los microscrollers: ![](https://content.gitbook.com/content/hGRTr5J3e6YsZ6MYIEDz/blobs/4XxUafmEGACBLL7iruYp/microscrollers.jpg), que permiten aumentar/disminuir en una unidad el valor actual.

### Tooltip

Permite especificar un texto que se presentará al usuario final de la aplicación cuando pase el cursor del ratón sobre el control. Podemos definir un texto por cada idioma presente en el [proyecto](../../..).

### Seleccionable con Tab

Permite que el control sea accesible cuando use el tabulador o el intro para moverse de un control a otro dentro del formulario.

### Condición visible

Permite especificar una condición para que el control sea visible. La condición se establecerá mediante una fórmula que podremos escribir usando el [asistente para edición de fórmulas](../../../editores/asistente-de-formulas). Para ello pulsar el botón que aparece al editar esta propiedad.

### Condición activo

Permite especificar una condición para que el control sea funcional. La condición se establecerá mediante una fórmula que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad.

### Sólo lectura

Permite hacer que el contenido del control pueda ser visualizado pero no modificado.

### Contenido

Permite establecer el contenido a editar en el control, en este caso podrá ser tanto un campo tipo de objeto texto enriquecido como cualquier fórmula que devuelva una cadena alfanumérica. Éste se establecerá mediante una fórmula que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad.

### Color de primer plano

En esta propiedad seleccionaremos el color de primer plano del control. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y/o seleccionar otro color.

### Color de base

En esta propiedad seleccionaremos el color de fondo del control. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y/o seleccionar otro color.

### Color de texto

En esta propiedad seleccionaremos el color que tendrá el texto contenido en el control. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.

### Color de botón

En esta propiedad seleccionaremos el color que tendrán los botones contenidos en el control. Junto al nombre del color se presenta una muestra del mismo, pulsar sobre ella para editarlo y o seleccionar otro color.

### Fondo opaco

Esta propiedad permite hacer transparente el fondo del control o aplicar un color opaco al fondo del mismo. Se tomará el color establecido en la propiedad [color de base](#color-de-base).

### Fuente

Esta propiedad permite establecer la fuente que usará el control. Pulsar el botón que aparece al editar esta propiedad para abrir el [selector de fuentes](../../../editores/selector-de-fuentes).

### Alineamiento vertical

Permite configurar la forma en la que el texto del control será alineado entre los los márgenes superior e inferior del mismo. Los valores posibles son:

#### Arriba

Alinea la parte superior del contenido con el margen superior del control.

#### Abajo

Alinea la parte inferior del contenido con el margen inferior del control.

#### Centrado

Alinea el contenido entre los másgenes superior e inferior del control.

### Barras de scroll

Esta propiedad permite configurar la visualización de las barras de scroll o de desplazamiento embebidas en el control. Los valores posibles son:

#### Automático

Las barras de scroll solamente se verán en el caso de que el tamaño del control no permita ver la totalidad de su contenido.

#### Nunca

Las barras de scroll nunca serán mostradas.

#### Siempre

Las barras de scroll aparecerán siempre.

### Barra de herramientas

Esta propiedad permite configurar la visualización de la barra de herramientas para la edición de texto embebida en el control. Los valores posibles son:

#### Ninguna

No se incluirá ninguna barra de herramientas.

#### Texto

Se incluirá la barra de herramientas y todos sus botones contendrán texto únicamente.

#### Iconos

Se incluirá la barra de herramientas y todos sus botones contendrán iconos únicamente.

#### Texto e iconos

Se incluirá la barra de herramientas y todos sus botones contendrán texto e iconos.

### Estilos de texto

Esta propiedad permite habilitar en la **barra de herramientas** los comandos de estilos de texto.

### **Formato**

Esta propiedad permite habilitar en la **barra de herramientas** los comandos de formato de texto.

### Alineación

Esta propiedad permite habilitar en la **barra de herramientas** los comandos de alineamiento de texto.

### Numeración y viñetas

Esta propiedad permite habilitar en la **barra de herramientas** los comandos para la creación de numeración y viñetas en el texto a editar.

### Ancho en layout

Permite establecer cómo se comportará el control dentro del layout. Los valores posibles son:

#### Por defecto

Asume el comportamiento que tiene establecido el tipo de control en el sistema. Los controles de caja de texto, por defecto, crecerán en anchura proporcionalmente a la anchura del formulario.

#### Fijo

El ancho del control será fijo, no variará para adaptarse a la anchura del formulario.

#### Proporcional

El ancho del control crecerá con el formulario siguiendo las mismas proporciones establecidas en el editor con respecto al resto de los controles del layout.

### Alto en layout

Permite establecer cómo se comportará el control dentro del layout. Los valores posibles son:

#### Por defecto

Asume el comportamiento que tiene establecido el tipo de control en el sistema. Los controles de caja de texto, por defecto, crecerán en altura proporcionalmente a la altura del formulario.

#### Fijo

La altura del control será fija, no variará para adaptarse a la altura del formulario.

#### Proporcional

La altura del control crecerá con el formulario siguiendo las mismas proporciones establecidas en el editor con respecto al resto de los controles del layout.

### Tipo de menú de contexto

Permite asignar un menú de contexto al control. Los valores posibles son:

#### Ninguno

En ejecución el control carecerá de menú de contexto.

#### Por defecto

En ejecución se usará el menú de contexto por defecto del control. No todos los controles por defecto tienen menú de contexto.

#### Personalizado

Permite indicar que el control usará un objeto [menú](../../menu) declarado en el [proyecto de aplicación ](../..)o en cualquier proyecto [heredado](../../../../herencia).

#### Menú de contexto

Este parámetro solamente estará disponible si en el parámetro anterior hemos seleccionado el valor **personalizado**. En él seleccionaremos el objeto menú proyecto de aplicación declarado en el heredado o en cualquier proyecto que queremos usar como menú de contexto del control.

#### Ficha extensión

Indica que lo que editaremos en el control no será un campo de la ficha asociada al formulario, sino de una [extensión de ficha ](../fichas-de-extension)declarada en el mismo.

Si estamos editando un texto en un control de este tipo la pulsación de la tecla Intro lo que hará será añadir un salto de línea dentro del control, si queremos aceptar el formulario que contiene el control tendremos que pulsar la combinación de las teclas ctrl+intro.

Si estamos editando un texto en un control de este tipo, el tabulador pasará al siguiente control en el orden tab, si queremos insertar un carácter tabulador en el control usaremos la combinación de las teclas ctrl+tabulador.
