Áreas de entrada

Agrega una variable de tipo Cadena editable llamada "Variable". Puede utilizar la lista de propiedades para modificar su tipo u otras propiedades.

Para más información sobre el uso de variables en formularios, consulte Get list item font.

Para más información sobre el uso de variables en formularios, consulte Get list item font.

Agrega una lista jerárquica que incluye código de ejemplo en su método de objeto usado para implementar una jerarquía básica de varios niveles. Puede utilizar la lista de propiedades para modificar sus propiedades.

Al modificar el código de ejemplo en el método objeto, puede personalizar la jerarquía existente para satisfacer sus necesidades específicas.

Así es como aparece la lista en el formulario con su código de ejemplo por defecto:

Para más información sobre el uso de listas jerárquicas en formularios, consulte Listas jerárquicas y menús desplegables jerárquicos.

Agrega un objeto list box de tres columnas que puede utilizar para visualizar arrays de datos. Se utiliza la lista de propiedades para especificar la fuente de datos y definir las opciones deseadas.

Para más información acerca del uso de los list boxes en formularios, consulte la sección Presentación para list boxes.

Añade un área de desplazamiento que consiste en un list box de una sola columna cuyos encabezados y pies no se muestran. Esta área no es editable por defecto, pero puede configurarla utilizando la lista de propiedades.

Para más información sobre el uso de las áreas de desplazamiento en formularios, consulte la sección Presentación para list boxes.

Añade un área imagen que puede configurar utilizando la lista de propiedades, por ejemplo, para agregar un menú contextual o incluir un formato de visualización.

Para más información acerca del uso de variables imagen en formularios, consulte .

Añade una variable Cadena editable asociada a una hoja de estilo "Contraseña", que muestra los caracteres introducidos como asteriscos. Puede utilizar la lista de propiedades para modificar sus propiedades.

Al introducir texto en un área de contraseña en un formulario, se muestran asteriscos únicamente:

Para más información sobre el uso de variables en formularios, consulte Get list item font. También puede hacer referencia a la sección Hojas de estilo para más información.

Añade un área SearchPicker que incluye código de ejemplo personalizable en su método objeto. Puede utilizar la lista de propiedades para modificar sus propiedades.

Puede modificar el código de ejemplo en el método de objeto con el fin de personalizar la etiqueta mostrada en esta área mediante el comando SearchPicker SET HELP TEXT.

Está es el área de búsqueda en un formulario:

Para más información, consulte Presentación del widget SearchPicker.

Añade un área de texto enriquecido, junto con un conjunto de menús y botones para gestionar los estilos de fuente y referencias.

Esta área de texto enriquecido consiste en una variable dinámica llamada "READ_Text". Para que los menús y botones de esta área funcionen correctamente, es importante que NO modifique este nombre.

Nota: para que las referencias XLIFF se copien en su base, deberá reiniciarla después de dejar a esta área en un formulario.

Hay dos variables offscreen utilizadas para guardar las referencias de menú del color de fuente y de fondo. Cuando están presentes, los menús se construirán "On Load" y liberarán "On Unload".

Nota: si se eliminan estas variables (no recomendado), estos menús tendrán que ser creados (y eliminados) cada vez que un usuario haga clic en los botones de color de fuente o de fondo.

También hay un botón offscreen button labeled "Init" con la etiqueta "Init", cuyo propósito es copiar ciertos recursos de la aplicación 4D en su base de datos.

Estos recursos son utilizados dentro de los botones y en el menú de color. Sólo necesitan ser copiados una vez y este botón deben eliminarse una vez su script ha sido ejecutado.

Cuando el formulario está en modo usuario, el área de texto enriquecido aparece así:

Los siguientes menús y botones se incluyen por defecto con el área de texto enriquecido:

	Utilice estos menús desplegables para seleccionar la fuente y su tamaño.
	Botones de estilo normal, negrita, cursiva, subrayado y tachado.
	Botones para definir el color de fuente y el color de fondo, respectivamente.
	Botones para insertar una URL o una expresión (respectivamente).
	Botón para mostrar expresiones como referencias (cadenas) en lugar de valores.
	Utilice estos botones para calcular o congelar, respectivamente, las expresiones en el texto.

Al dejar caer este objeto en un formulario inserta automáticamente un área 4D Write Pro con un subformulario asociado 4D Write Pro Widget que contiene los paneles de control para gestionar el contenido del área:

Nota: para obtener más información sobre 4D Write Pro, por favor consulte el manual dedicado Referencia 4D Write Pro.

En modo usuario, por defecto este panel se muestra con una barra de herramientas que contiene 8 iconos. Al seleccionar cada icono en la barra de herramientas se muestra un panel de control diferente (se detallan a continuación):

	Estilo de fuente
	Márgenes y alineaciones
	Tabulaciones
	Unidades y Tamaños
	Marcos
	Fondo
	Base e información
	Marcadores

Además, hay un botón Copiar/Pegar (esquina inferior izquierda de la mayoría de los paneles) con un menú contextual dinámico que se adapta al contenido del panel. Por ejemplo, en el panel Estilo de fuente, después de haber copiado una selección de texto con estilo, el menú incluye automáticamente un elemento "Pegar estilo":

Este panel gestiona los estilos de fuente estándar y las propiedades de texto del área 4D Write Pro.

Los elementos disponibles en el menú Estilo varían en función de la fuente seleccionada:

Nota: el tamaño de fuente está siempre en puntos, independientemente de la unidad definida para el documento.

El menú Alin. vert. permite cambiar el texto a superíndice o subíndice y el menú Transformar permite elegir entre las diferentes combinaciones de tipo de fuente:

El botón Copiar/Pegar copia el estilo aplicado al texto seleccionado. El menú de este botón añade automáticamente un elemento "Pegar estilo" después de haber copiado una selección de texto para que pueda volver a aplicar su estilo en otras partes. Tenga en cuenta que este mecanismo sólo funciona cuando se copia una selección de texto con un estilo homogéneo.

Este panel administra las propiedades de alineación estándar del texto y define los márgenes del área 4D Write Pro.

Además de los ajustes generales que se aplican a todo el documento, la alineación del texto y los márgenes se pueden ajustar de forma independiente para cada párrafo y/o imagen en el texto. Utilice los iconos en la parte superior del panel para configurar estos ajustes por separado para el área deseada ( para el documento, para un párrafo individual y para una imagen ubicada en el texto).

El botón Copiar/Pegar se puede utilizar para copiar y pegar los ajustes de texto y/o los márgenes del texto seleccionado.

Este panel gestiona las tabulaciones de los párrafos en el área 4D Write Pro. Todo valor Indentación definido, ya sea mediante el deslizador o introduciendo un valor directamente en el área, se utiliza de forma predeterminada como la distancia de desplazamiento entre las pestañas posteriores añadidas. Cuando se elige un Tipo usando uno de los botones, se aplica este tipo a todas las tabulaciones existentes para el párrafo.

Puede cambiar manualmente las tabulaciones individuales en la lista mediante la introducción de un nuevo valor Posición directamente en la celda y/o seleccionando un nuevo Tipo en el menú desplegable:

Nota: el cambio de Indentación o Tipo utilizando los controles en la parte superior del panel anulará cualquier cambio manual a tabulaciones individuales en la lista de tabulaciones.

Al hacer clic en el botón una nueva tabulación predeterminada al párrafo. Es posible eliminar una tabulación seleccionándola en la lista y haciendo clic en el botón .

Las tabulaciones se aplican al párrafo actual o a una selección de párrafos. También puede utilizar el botón Copiar/Pegar para copiar y pegar los parámetros de tabulación.

Este panel define las unidades estándar utilizadas para el documento 4D Write Pro y define el tamaño de los párrafos y de las imágenes que contiene.

Las unidades son definidas para todo el documento. Nota: independientemente de la unidad definida para el documento, el tamaño de fuente (ver el panel ), así como también el ancho de línea y el radio de los marcos (ver el panel ) siempre se definen en puntos.

Los párrafos pueden tener una ancho fijo o variable y las imágenes se pueden definir con un tamaño fijo o un ancho/alto mínimo. Cuando el tamaño se define como "Auto", se basa en el contenido del elemento.

Este panel gestiona los marcos y rellenos (márgenes inferiores) en el área 4D Write Pro.

Los marcos se pueden definir para la totalidad del documento o para los párrafos individuales, o para las imágenes que se encuentran en el texto. Utilice los iconos de la parte superior del panel para configurar estos ajustes por separado para el área deseada: es decir para el documento, para un párrafo individual y para una imagen en el texto.

Nota: los estilos de marco doble, surco, relieve y bisel, no pueden ser claramente visibles en el ancho predeterminado (1 pt).

La opción Radio permite definir esquinas redondeadas a los marcos. Nota: esta configuración no se puede definir para los estilos de marco surco, relieve y bisel.

El botón Copiar/Pegar copia y pega el marco, así como también el relleno entre dos párrafos (o dos imágenes).

Este panel gestiona las imágenes de fondo para el área 4D Write Pro. Puede arrastrar y soltar imágenes o URLs directamente en el área Imagen. Además, un clic derecho en el área Imagen muestra una lista desplegable donde varios patrones de fondo están disponibles por defecto.  Es posible ajustar la posición y el tamaño de cada imagen o patrón utilizado y definir los ajustes personalizados. Puede utilizar el icono   para eliminar una imagen o patrón existente.

Las imágenes de fondo se pueden definir a nivel del documento () y/o de los párrafos individuales (). También puede establecer una imagen de fondo de una imagen incluida en el texto ().

El botón Copiar/Pegar copia y pega la imagen de fondo, junto con su configuración de un párrafo (o imagen) a otro.

Este panel inserta y administra las expresiones 4D y las URLs en el área 4D Write Pro e incluye un área para la introducción de información útil sobre el documento.

Los siguientes controles están disponibles:

• Fecha: inserta la fecha actual en la ubicación actual.
• Expresión (botón): abre el Editor de fórmulas para que pueda crear o cargar una expresión 4D existente que se insertará en la posición actual.
• Expresión (área): muestra la referencia de la expresión 4D seleccionada. Puede insertar expresiones especiales relacionadas con atributos documento o atributos de página. Para más información, consulte [#title id="3699" anchor="2995042"/].
• Mostrar valores/expresiones: alterna entre la visualización de expresiones 4D como referencias o sus valores actuales.
• Calcular: actualiza los valores de las expresiones 4D en el documento.
• Congelar: transforma expresiones 4D actuales en texto plano (no se puede deshacer).
• Selección únicamente: seleccione esta opción para limitar la acción de los botones Calcular y Congelar para el texto seleccionado en el área 4D Write Pro. Cuando esta casilla no está marcada, estas acciones se aplicarán en todo el documento.
• Etiqueta/Enlace: muestra la dirección de enlace y la etiqueta de la URL seleccionada.
• Aplicar: muestra una caja de diálogo para que pueda introducir o modificar una URL (dirección y etiqueta).

Documento 
La información introducida en esta sección se almacena con el documento, pero no se muestra en otras partes. Por defecto, el "Título" es "4D Write Pro Nuevo documento". Las áreas "Creación" y "Modificación" en la sección Documento no pueden ser modificadas.

Este panel gestiona los marcadores de documentos en el área 4D Write Pro. Los marcadores son referencias dinámicas para intervalos específicos en este documento; si el rango asociado a un marcador se mueve, extiende o reduce, el marcador continúa haciendo referencia al mismo rango dentro del documento.

Para crear un marcador, seleccione el rango de texto que desea marcar y luego clic en el botón en la parte inferior del panel: una etiqueta "New_Bookmark1" aparece en la lista. Puede cambiar el nombre de un marcador en cualquier momento; al hacer clic en un marcador que está resaltado en la lista cambia su etiqueta a modo de edición. Los nombres de los marcadores deben estar compuestos de caracteres alfanuméricos estándar; los espacios se sustituyen automáticamente con guiones bajos.

También puede reinicializar los rangos del marcador sin cambiarles el nombre: sólo tiene que seleccionar el marcador que desea volver a definir en la lista, luego resaltar el nuevo rango de texto que desea marcar y hacer clic en el botón . Esta nuevo rango automáticamente sustituye al que estaba asociado antes con el marcador seleccionado.

La lista muestra los marcadores en el mismo orden en que aparecen en el documento. Puede eliminar un marcador seleccionándolo en la lista y haciendo clic en el botón .

Por defecto, el subformulario Widget 4D Write Pro ofrece un conjunto completo de paneles de control. El panel de control por defecto es el formulario detallado "WP_Palette". Sin embargo, también puede utilizar estos paneles de control individualmente seleccionando el formulario detallado correspondiente en la Lista de propiedades del editor de formularios:

Por ejemplo, si selecciona "WP_Palette_Fonts" como el formulario detallado, obtendrá algo como esto en su formulario:

La interfaz de los paneles de control se puede cambiar para utilizar skins y fuentes diferentes. Sólo tiene que modificar el método objeto del área 4D Write Pro asociada.

Asegúrese de que la variable objeto del área 4D Write Pro contenga los siguientes atributos obligatorios (se incluyen automáticamente en el método de objeto predeterminado):

• selection: utilizado por los comandos 4D Write Pro tales como WP GET ATTRIBUTES y WP SET ATTRIBUTES
• areaName: utilizado por los comandos ST.
  

• skinName: los valores pueden ser "black", "dark", "grey", "light", "white" o "night"
• backgroundColor: por ejemplo 0x00A0A0A0
• separatorColor: por ejemplo 0x00D04060
• fontColor: por ejemplo 0x002080C0
• separatorFontColor: por ejemplo 0x00803000
• font: font family, por ejemplo "Times"
• fontSize: por ejemplo 12
• scrollbar*: True o False
  *La barra de desplazamiento sólo se puede utilizar y activar cuando el objeto formulario 4D Write Pro puede ser redimensionado verticalmente (Propiedad Dim vertical en Agrandar)

Para más información sobre 4D Write Pro, consulte Atributos 4D Write Pro .

Ejemplo de código para la personalización de la interfaz de los paneles de control del widget: