Text
Autorizar selector fuente/color
Cuando esta propiedad está activada, los comandos OPEN FONT PICKER y OPEN COLOR PICKER pueden ser invocados para mostrar las ventanas de selección de fuente y color del sistema. A través de estas ventanas, los usuarios pueden cambiar la fuente o el color de un objeto formulario que tenga el foco directamente haciendo clic. Cuando esta propiedad está desactivada (por defecto), los comandos del selector abierto no tienen efecto.
Gramática JSON
| Propiedad | Tipos de datos | Valores posibles |
|---|---|---|
| allowFontColorPicker | boolean | false (por defecto), true |
Objetos soportados
Negrita
Ajusta el texto seleccionado para que aparezca más oscuro y pesado.
Puede definir esta propiedad utilizando el comando OBJECT SET FONT STYLE.
Esto es texto normal.
Esto es texto en negrita.
Gramática JSON
| Propiedad | Tipos de datos | Valores posibles |
|---|---|---|
| fontWeight | text | "normal", "bold" |
Objetos soportados
Botón - Casilla de verificación - Combo Box - Lista desplegable - Group Box - Lista jerárquica - Entrada - List Box - Columna de List Box - Pie de List Box - Encabezado de List Box - Botón de opción - Área de texto
Itálica
Hace que el texto seleccionado se incline ligeramente hacia la derecha.
También puede definir esta propiedad por medio del comando OBJECT SET FONT STYLE.
Esto es texto normal.
Este es texto en cursiva.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| fontStyle | string | "normal", "italic" |
Objetos soportados
Botón - Casilla de verificación - Combo Box - Lista desplegable - Group Box - Lista jerárquica - Entrada - List Box - Columna de List Box - Pie de List Box - Encabezado de List Box - Botón de opción - Área de texto
Subrayado
Hace que el texto tenga una línea por debajo.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| textDecoration | string | "normal", "underline" |
Objetos soportados
Botón - Casilla de verificación - Combo Box - Lista desplegable - Group Box - Lista jerárquica - Entrada - List Box - Columna de List Box - Pie de List Box - Encabezado de List Box - Botón de opción - Área de texto
Fuente
Esta propiedad permite indicar el tema de la fuente o la familia de fuente utilizada en el objeto.
Las propiedades Tema de la fuente y de la familia de la fuente son mutuamente excluyentes. Un tema de fuente se encarga de los atributos de fuente, incluido el tamaño. Una familia de fuentes permite definir el nombre, el tamaño y el color de la fuente.
Tema de fuente
La propiedad de tema de fuente designa un nombre de estilo automático. Los estilos automáticos determinan de forma dinámica la familia de fuentes, el tamaño y el color de la fuente que se utilizará para el objeto, según los parámetros sistema. Estos parámetros dependen de:
- la plataforma,
- el lenguaje del sistema,
- y el tipo de objeto de formulario.
Con el tema de fuente, se garantiza que los títulos se muestren siempre de acuerdo con los estándares actuales de la interfaz del sistema. Sin embargo, su tamaño puede variar de una máquina a otra.
Hay tres temas de fuentes disponibles:
- normal: estilo automático, aplicado por defecto a todo nuevo objeto creado en el editor de formularios.
- Los temas de fuentes principales y suplementarios solo son soportados por las áreas de texto y las áreas de entrada. Estos temas están pensados principalmente para diseñar cajas de diálogo. Se refieren a los estilos de fuente utilizados, respectivamente, para el texto principal y la información adicional en las ventanas de su interfaz. A continuación se muestran las cajas de diálogo típicas (macOS y Windows) que utilizan estos temas de fuentes:
Los temas de fuentes gestionan la fuente, así como su tamaño y color. Puede aplicar propiedades de estilo personalizadas (Negrita, Cursiva o Subrayado) sin alterar su funcionamiento.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| fontTheme | string | "normal", "main", "additional" |
Objetos soportados
Botón - Casilla de verificación - Combo Box - Lista desplegable - Group Box - Lista jerárquica - Entrada - List Box - Columna de List Box - Pie de List Box - Encabezado de List Box - Botón de opción - Área de texto
Familia de fuentes
Hay dos tipos de nombres de familias de fuentes:
- family-name: El nombre de una familia de fuentes, como "times", "courier", "arial", etc.
- generic-family: El nombre de una familia genérica, como "serif", "sans-serif", "cursive", "fantasy", "monospace".
Puede configurarlo utilizando el comando OBJECT SET FONT.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| fontFamily | string | Nombre de la familia de fuentes CSS |
4D recomienda utilizar sólo fuentes seguras para la web.
Objetos soportados
Botón - Casilla de verificación - Combo Box - Lista desplegable - Group Box - Lista jerárquica - Entrada - List Box - Columna de List Box - Pie de List Box - Encabezado de List Box - Botón de opción - Área de texto
Tamaño fuente
Permite definir el tamaño de la fuente del objeto en puntos.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| fontSize | integer | Tamaño de letra en puntos. Valor mínimo: 0 |
Objetos soportados
Botón - Casilla de verificación - Combo Box - Lista desplegable - Group Box - Lista jerárquica - Entrada - List Box - Columna de List Box - Pie de List Box - Encabezado de List Box - Botón de opción - Área de texto
Color de fuente
Designa el color de la fuente.
Esta propiedad también define el color de borde (si lo hay) del objeto cuando se utiliza el estilo "plano" o "punteado".
El color puede ser especificado por:
- un nombre de color - como "red"
- un valor HEX - como "# ff0000"
- un valor RVB - como "rgb (255,0,0)"
También puede definir esta propiedad utilizando el comando OBJECT SET RGB COLORS.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| stroke | string | un valor css, "transparent", "automatic" |
Objetos soportados
Botón - Casilla de verificación - Combo Box - Lista desplegable - Group Box - Lista jerárquica - Entrada - List Box - Columna de List Box - Pie de List Box - Encabezado de List Box - Indicadores de progreso - Regla - Botón radio - Área de texto
Expresión color fuente
List box de tipo colección/selección de entidades
Se utiliza para aplicar un color de fuente personalizado a cada línea del list box. Debe utilizar valores de color RGB. Para más información al respecto, consulte la descripción del comando OBJECT SET RGB COLORS en el manual Lenguaje de 4D.
Debe introducir una expresión o una variable (no se pueden utilizar variables de tipo array). La expresión o variable se evaluará para cada línea mostrada. Puede utilizar las constantes del tema SET RGB COLORS.
También puede definir esta propiedad utilizando el comando LISTBOX SET PROPERTY con la constante lk font color expression.
Esta propiedad también puede definirse mediante una Expresión Meta Info.
El siguiente ejemplo utiliza un nombre de variable: introduzca CompanyColor para la Expresión color fuente y, en el método formulario, escriba el siguiente código:
CompanyColor:=Choose([Companies]ID;Background color;Light shadow color;
Foreground color;Dark shadow color)
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| rowStrokeSource | string | Expresión color fuente |
Objetos soportados
Expresión estilo
List box de tipo colección/selección de entidades
Utilizado para aplicar un estilo de fuente personalizado a cada línea de list box o de cada celda de la columna.
Debe introducir una expresión o una variable (no se pueden utilizar variables de tipo array). La expresión o variable se evaluará para cada línea mostrada (si se aplica al list box) o cada celda mostrada (si se aplica a una columna). Puede utilizar las constantes del tema Estilos de fuentes.
Ejemplo:
Choose([Companies]ID;Bold;Plain;Italic;Underline)
También puede definir esta propiedad utilizando el comando LISTBOX SET PROPERTY con la constante lk font style expression.
Esta propiedad también puede definirse mediante una Expresión Meta Info.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| rowStyleSource | string | Expresión de estilo a evaluar para cada línea/celda. |
Objetos soportados
Alineación horizontal
Ubicación horizontal del texto dentro del área que lo contiene.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| textAlign | string | "right", "center", "left", "automatic", "justify" |
- "automatic" no es compatible con casillas de selección y botones radio
- "justify" sólo es compatible con las entradas y áreas de texto
Objetos soportados
Botón - Casilla de verificación (todos los estilos excepto Regular y Plano) - Caja de grupo - Entrada - List Box - Columna List Box - Encabezado List Box - Pie List Box - Botón de opción (todos los estilos excepto Regular y Plano) - Área de texto
Alineamiento vertical
Ubicación vertical del texto dentro del área que lo contiene.
La opción Predeterminado (automático valor JSON) define la alineación según el tipo de datos que se encuentran en cada columna:
abajopara todos los datos (excepto las imágenes) yarribapara los datos del tipo imagen.
Esta propiedad también puede ser manejada por los comandos OBJECT Get vertical alignment y OBJECT SET VERTICAL ALIGNMENT.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| verticalAlign | string | "automatic", "top", "middle", "bottom" |
Objetos soportados
List Box - Columna List Box - Pie de List Box - Encabezado List Box
Meta Info expression
List boxes de tipo Collection o entity selection
Indica una expresión o una variable que se evaluará para cada línea mostrada. Permite definir todo un conjunto de atributos texto de las líneas. Debe pasar una variable objeto o una expresión que devuelva un objeto. Se soportan las siguientes propiedades:
| Nombre de propiedad | Tipo | Descripción |
|---|---|---|
| stroke | string | Color de la fuente. Todo color CSS (por ejemplo: "#FF00FF"), "automatic", "transparent" |
| fill | string | Color de fondo. Todo color CSS (por ejemplo: "#F00FFF"), "automatic", "transparent" |
| fontStyle | string | "normal","italic" |
| fontWeight | string | "normal","bold" |
| textDecoration | string | "normal","underline" |
| unselectable | boolean | Designa la línea correspondiente como no seleccionable (* es decir, *, no es posible el resaltado). Las áreas que se pueden introducir ya no se pueden introducir si esta opción está activada, a menos que la opción "Edición con un solo clic" también esté activada. Los controles como las casillas de selección y las listas siguen siendo funcionales. Esta configuración se ignora si el modo de selección del list box es "Ninguno". Valores por defecto: False. |
| disabled | boolean | Desactiva la línea correspondiente. Las áreas editables ya no son accesibles si esta opción está activada. Texto y controles (casillas de verificación, listas, etc.) aparecen atenuados o desactivados. Valores por defecto: False. |
La propiedad especial "cell" permite aplicar un conjunto de propiedades a una sola columna:
| Nombre de propiedad | Tipo | Descripción | ||
|---|---|---|---|---|
| cell | object | Propiedades aplicables a una o varias columnas | ||
| columnName | object | columnName es el nombre del objeto de la columna del list box | ||
| propertyName | string | las propiedades "stroke", "fill", "fontStyle", "fontWeight" o "textDecoration" (ver arriba). Nota: las propiedades "no seleccionable" y "desactivada" sólo pueden definirse a nivel de la línea. Se ignoran si se pasan en el objeto "celda" |
Los ajustes de estilo hechos con esta propiedad son ignorados si otros ajustes de estilo ya están definidos a través de expresiones (*por ejemplo, Expresión de estilo, Expresión de color de fuente, Expresión de color de fondo).
Ejemplos
En un método proyecto Color, escriba el siguiente código:
//Método Color
//Define el color de la fuente para ciertas líneas y el color de fondo para las columnas Col2 y Col3
Form.meta:=New object
If(This.ID<5) //ID es un atributo de los objetos/entidades de la colección
Form.meta.stroke:="purple"
Form.meta.cell:=New object("Col2";New object("fill";"black");\
"Col3";New object("fill";"red"))
Else
Form.meta.stroke:="orange"
End if
Buenas prácticas: por razones de optimización, normalmente se recomienda crear el objeto meta.cell una vez en el método del formulario:
//método formulario
Case of
:(Form event code=On Load)
Form.colStyle:=New object("Col2";New object("fill";"black");\
"Col3";New object("fill";"red"))
// también puede definir otros conjuntos de estilos
Form.colStyle2:=New object("Col2";New object("fill";"green");\
"Col3";New object("fontWeight";"bold"))
End case
Entonces, el método Color contendría:
//Método Color
...
If(This.ID>5)
Form.meta.stroke:="purple"
Form.meta.cell:=Form.colStyle //reuse el mismo objeto para un mejor rendimiento
Else
Form.meta.stroke:="orange"
Form.meta.cell:=Form.colStyle2
End if
...
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| metaSource | string | Expresión de objeto a evaluar para cada línea/celda. |
Objetos soportados
Multistyle
Esta propiedad permite la posibilidad de utilizar estilos específicos en el área seleccionada. Cuando esta opción está marcada, 4D interpreta todas las etiquetas <SPAN> HTML presentes en el área.
Por defecto, esta opción no está activa.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| styledText | boolean | true, false |
Objetos soportados
Área de entrada - Columna List Box
Orientación
Modifica la orientación (rotación) de un área de texto. Las áreas de texto pueden girarse en incrementos de 90°. Cada valor de orientación se aplica manteniendo el mismo punto de partida inferior izquierdo para el objeto:
| Valor de orientación | Result |
|---|---|
| 0 (por defecto) |  |
| 90 |  |
| 180 |  |
| 270 |  |
Además de áreas de texto estáticas, los objetos de texto de las áreas de entrada pueden girar cuando no soneditables. Cuando se aplica una propiedad de rotación a un objeto de entrada, se elimina la propiedad editable (si la hay). Este objeto se excluye entonces del orden de entrada.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| textAngle | number | 0, 90, 180, 270 |
Objetos soportados
Entrada (no editable) - Área de texto
Array colores de fuente
List boxes de tipo array
Permite definir un color de fuente personalizado para cada línea del list box o celda de la columna.
Se debe utilizar el nombre de un array Entero largo. Cada elemento de este array corresponde a una línea del list box (si se aplica al list box) o a una celda de la columna (si se aplica a una columna), por lo que el array debe tener el mismo tamaño que el array asociado a la columna. Puede utilizar las constantes del tema SET RGB COLORS. Si desea que la celda herede el color de fondo definido en el nivel superior, pase el valor -255 al elemento del array correspondiente.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| rowStrokeSource | string | El nombre de un array entero largo |
Objetos soportados
Array de estilos
List boxes de tipo array
Permite definir un estilo de fuente personalizado para cada línea del list box o cada celda de la columna.
Se debe utilizar el nombre de un array Entero largo. Cada elemento de este array corresponde a una línea del list box (si se aplica al list box) o a una celda de la columna (si se aplica a una columna), por lo que el array debe tener el mismo tamaño que el array asociado a la columna. Para llenar el array (utilizando un método), utilice las constantes del tema Estilos de fuente. Se pueden añadir constantes para combinar estilos. Si desea que la celda herede el estilo definido en el nivel superior, pase el valor -255 al elemento del array correspondiente.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| rowStyleSource | string | El nombre de un array entero largo. |
Objetos soportados
Almacenar con etiquetas de estilo por defecto
Esta propiedad sólo está disponible para un área de entrada Multi-estilo. Cuando esta propiedad está activada, el área almacenará las etiquetas de estilo con el texto, incluso si no se ha realizado ninguna modificación. En este caso, las etiquetas corresponden al estilo por defecto. Cuando esta propiedad está desactivada, sólo se almacenan las etiquetas de estilo modificadas.
Por ejemplo, este es un texto que incluye una modificación de estilo:
Cuando la propiedad está desactivada, el área sólo almacena la modificación. Por lo tanto, los contenidos almacenados son:
¡Qué <SPAN STYLE="font-size:13.5pt">hermoso</SPAN> día!
Cuando la propiedad está activa, el área almacena toda la información de formato. La primera etiqueta genérica describe el estilo por defecto y luego cada variación es objeto de un par de etiquetas anidadas. Por lo tanto, los contenidos almacenados en el área son:
<SPAN STYLE="font-family:'Arial';font-size:9pt;text-align:left;font-weight:normal;font-style:normal;text-decoration:none;color:#000000;background-color:#FFFFFF">¡Qué <SPAN STYLE="font-size:13.5pt">hermoso</SPAN> día!</SPAN>
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| storeDefaultStyle | boolean | true, false (por defecto). |