Editor de texto enriquecido

Usa el control Editor de texto enriquecido para permitir que los usuarios compongan texto enriquecido desde la aplicación. Este texto se puede utilizar como contenido de correo electrónico, contenido de marketing y mucho más.

Tiempo de diseño

General

• Texto de sugerencia: el texto de ayuda que se mostrará en el tiempo de ejecución.
• Texto predeterminado: el contenido predeterminado que se mostrará en tiempo de ejecución. Si esta propiedad está vinculada a una variable de aplicación, los cambios en el valor predeterminado no se propagarán a la variable de aplicación. Para actualizar los valores en las variables de la aplicación, debes utilizar una regla Establecer valor .
• Etiqueta: el texto de visualización del control.
• Obligatorio: si es verdadero, los usuarios de la aplicación deben proporcionar datos en el control. Para marcar el control como obligatorio en tiempo de ejecución, se añade un asterisco * después del texto de la etiqueta.
• Mensaje de error personalizado: texto que aparece si se establece la propiedad Requerida como verdadero y el control se deja vacío.
• Oculto: si es verdadero, oculta el control en tiempo de ejecución.
• Solo lectura: si es verdadero, no se puede añadir texto en tiempo de ejecución, pero se muestra el contenido existente y no se puede editar.

Events

• Valor cambiado: configura lo que sucede cuando se cambia el contenido.

Estilo

• Alineación de control: por defecto, hereda la alineación principal. Se puede establecer una alineación diferente a la principal. Para volver a la alineación principal, anula la selección de las opciones anuladas.

  Nota: la alineación depende del diseño seleccionado para el elemento principal (Vertical vs Horizontal).
• Colocación de la etiqueta: por defecto, la etiqueta está configurada para que se muestre en la parte superior del control, en el lado izquierdo. Puedes colocarlo a la izquierda del control, en la misma línea. La propiedad Ancho de la etiqueta configura el ancho de la etiqueta, y la propiedad Espacio entre establece la distancia entre la etiqueta y el control.

• Fuente: los atributos de fuente tanto para el texto de la etiqueta, como para la familia de fuentes, el tamaño, el color o el estilo (negrita, cursiva y subrayado). Por defecto, el control hereda la familia de fuentes del contenedor principal inmediato, que se indica con la palabra clave "heredada".

• Margen: el margen del control. De forma predeterminada, se establece un margen de 4px. Se combinan las propiedades de los márgenes superiores/inferiores e izquierdos/derechos. Estas propiedades se pueden separar utilizando el botón Enlace situado a la derecha de la sección Margen.
• Tamaño: el ancho y la altura del control. El tamaño está establecido como auto de forma predeterminada. Para establecer valores mínimos o máximos, haz clic en el icono de tres puntos (...). Si el tamaño del control es menor que las opciones, se muestra una barra de desplazamiento.

Nota: cuando la alineación del control se establece en Estiramiento y el control principal se establece en Permitir ajuste, el control Editor de texto enriquecido no se extiende a la altura completa. Para evitarlo, puedes eliminar la alineación de Estiramiento o proporcionar una altura explícita para el control.

Tiempo de ejecución

Información general

Utiliza este control para componer texto enriquecido directamente desde la aplicación en tiempo de ejecución.

Nota: si seleccionas la casilla Solo lectura durante el tiempo de ejecución, la interfaz del Editor de texto enriquecido cambia: los controles de edición están ocultos y no se puede añadir nuevo texto ni editar el existente.

Interfaz

La interfaz ofrece capacidades útiles, por ejemplo:

• Estilo de fuente: personaliza la fuente. Puedes elegir entre las siguientes opciones:

  • Negrita
  • Itálica
  • Subrayar
  • Lista con viñetas: crea una lista con viñetas.
  • Lista numerada: crea una lista numerada.
  • Tabla: crea una tabla. Puedes cambiar el estilo de la tabla (tamaño, alineación, color de fondo, borde) seleccionando Propiedades de tabla en el menú desplegable.
  • Gama tipográfica
  • Tamaño de fuente
  • Color de texto
  • Color de fondo del texto

• Alineación: alinea el contenido procedente del Editor de texto enriquecido.

  • Alinear a la izquierda: alinea el texto al borde izquierdo.
  • Alinear a la derecha: alinea el texto al borde derecho.
  • Alinear al centro: alinea el texto centrándolo entre dos bordes.
  • Justificar: aumenta el espacio entre palabras para llenar toda la línea, de forma que el texto se alinee tanto al borde izquierdo como al derecho.
• Disminuir y Aumentar sangría: aumenta o disminuye el espacio entre el margen izquierdo y el derecho de un párrafo.
• Altura de línea: cambia el espacio entre dos filas.
• Superíndice y Subíndice: formatea el texto para que quede ligeramente por encima (superíndice) o por debajo (subíndice) de la línea normal de escritura.
• Eliminar formato: elimina todo el formato de un bloque de texto seleccionado, de un párrafo o de todo el texto.
• Insertar/editar imagen: inserta una imagen desde un Cubo de almacenamiento.
• Bloque: indica que se cita una gran selección de texto procedente de otro origen.
• Línea horizontal: inserta una línea horizontal.
• Insertar/editar enlace: inserta o edita una URL pública. También puedes configurarlo para que se abra en la misma ventana o en una ventana nueva.
• Deshacer y Rehacer: deshace cualquier cambio o los vuelve a hacer si hace falta.

Atajos del teclado

Importante:

Actualmente, los atajos de teclado CTRL+C y CTRL+V no funcionan en máquinas Windows para incrustar imágenes o para ventanas emergentes de imagen mostradas en el control Editor de texto enriquecido.

Utiliza CTRL+SHIFT+C y CTRL+SHIFT+V en su lugar.

Puede usar los siguientes atajos de teclado para llegar a la barra de herramientas del control:

Tarea	PC (no macOS)	macOS
Enfocar o saltar a la barra de menús	ALT+F9	Opción+F9
Enfocar o saltar a la barra de herramientas	ALT+F10	Opción+F10

Propiedades VB

Propiedad VB	Tipo de datos	Descripción
Tooltip	Cadena	Texto de información que aparece cuando el usuario pasa el ratón por encima del Editor de texto enriquecido.
HintText	Cadena	Texto de marcador de posición que se muestra dentro del Editor de texto enriquecido.
Label	Cadena	La etiqueta del Editor de texto enriquecido, normalmente el texto que se muestra antes del control.
ReadOnly	Booleano	Si es verdadero, el editor de texto enriquecido es de solo lectura en tiempo de ejecución.
Value	Cadena	Valor actualmente seleccionado del editor de texto enriquecido.
Required	Booleano	Especifica si el valor del Editor de texto enriquecido es obligatorio.
RequiredErrorMessage	Cadena	Mensaje que se muestra cuando se requiere el valor del Editor de texto enriquecido pero no se proporcionó.
Hidden	Booleano	Determina la visibilidad del Editor de texto enriquecido. Si se establece en verdadero, oculta el control en tiempo de ejecución.
Disabled	Booleano	Determina si se puede interactuar con el editor de texto enriquecido . Si se establece en verdadero, deshabilita la interacción con el editor de texto enriquecido en tiempo de ejecución.
IsValid	Booleano	Comprueba la validez del valor del editor de texto enriquecido . Si es verdadero, indica que es válido.