Saltar al contenido principal
Versión: v20 R4 BETA

Configuring 4D View Pro Areas

Las propiedades del área 4D View Pro pueden configurarse utilizando la lista de propiedades. Las propiedades de las hojas de cálculo están disponibles a través del lenguaje.

Propiedades del área de formulario

Utilizando la lista de propiedades del área, puede configurar las propiedades objeto 4D View Pro como Nombre del objeto, Variable o expresión, Apariencia, Acción, y Eventos.

Selección de una interfaz usuario

Puede seleccionar la interfaz a utilizar con sus áreas de formulario 4D View Pro en la Lista de propiedades, en Apariencia:

También puede utilizar las propiedades JSON userInterface y withFormulaBar(sólo con la interfaz "toolbar").

Las interfaces permiten realizar modificaciones básicas y manipular los datos. Las modificaciones definidas por el usuario se guardan en el objeto 4D View Pro cuando el usuario guarda el documento.

Cinta

Toolbar (Barra de herramientas)

Al activar la interfaz de la barra de herramientas aparece la opción Mostrar barra de fórmula. Cuando se selecciona, la barra de fórmulas es visible debajo de la interfaz Barra de herramientas.

Con barra de fórmula visible:

Funcionalidades

Tanto la interfaz de la cinta de opciones como la de la barra de herramientas agrupan funciones relacionadas en pestañas:

PestañaAccionesInterfaz CintaInterfaz Barra de herramientas
FileGestión de archivosX
InicioApariencia del textoXX
InsertarAñadir elementosXX
FórmulasCálculos de fórmulas y libreríaXX
DatosGestión de los datosXX
MostrarPresentación visualXX
SettingsPresentación de la hojaX

Eventos formulario

Los siguientes eventos formulario están disponibles en la Lista de propiedades de las áreas 4D View Pro.

Algunos de los eventos son eventos formulario estándar (disponibles para todos los objetos activos) y otros son eventos formulario específicos de 4D View Pro. Algunos eventos formulario estándar suministran información extendida en el objeto devuelto por el comando FORM Event cuando son generados para las áreas 4D View Pro. La siguiente tabla indica los eventos estándar y los eventos específicos o los que ofrecen información adicional a las áreas 4D View Pro:

Evento 4D estándarEventos 4D View Pro específicos y extendidos
On LoadOn VP Ready
On Getting FocusOn Clicked
On Losing FocusOn Double Clicked
On UnloadOn Header Click
On After Edit
On Selection Change
On Column Resize
On Row Resize
On VP Range Changed

Opciones hoja

El objeto opciones hoja 4D View Pro le permite controlar varias opciones de sus áreas 4D View Pro. Este objeto es manejado por los siguientes comandos:

Apariencia de la hoja

PropiedadTipoDescripción
allowCellOverflowbooleanEspecifica si los datos pueden desbordarse hacia las celdas vacías adyacentes.
sheetTabColorstringUna cadena color utilizada para representar el color de la pestaña de la hoja, como "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc.
frozenlineColorstringUna cadena color utilizada para representar el color de la línea congelada, como "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", "Acento 5", etc.
clipBoardOptionsentero largoLa opción portapapeles. Valores disponibles: vk clipboard paste options all, vk clipboard paste options formatting, vk clipboard paste options formulas, vk clipboard paste options formulas and formatting, vk clipboard paste options values, vk clipboard paste options values and formatting
rejillaobjectLas opciones de la línea de rejilla.
colorstringUna cadena color utilizada para representar el color de la línea de la cuadrícula, como "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc.
showVerticalGridlinebooleanEspecifica si se debe mostrar la línea de la cuadrícula vertical.
showHorizontalGridlinebooleanEspecifica si mostrar o no la línea de rejilla horizontal.
rowHeaderVisiblebooleanEspecifica si el encabezado de la línea es visible.
colHeaderVisiblebooleanEspecifica si el encabezado de la columna es visible.
rowHeaderAutoTextentero largoEspecifica si el encabezado de la linea muestra letras o números o está en blanco. Valores disponibles: vk header auto text blank, vk header auto text letters, vk header auto text numbers
colHeaderAutoTextentero largoEspecifica si el encabezado de la columna muestra letras o números o está en blanco. Valores disponibles: vk header auto text blank, vk header auto text letters, vk header auto text numbers
selectionBackColorstringEl color de fondo de la selección para la hoja. (formato RGBA preferido)
selectionBorderColorstringEl color del borde de la selección para la hoja.
sheetAreaOffsetobjectLas opciones de sheetAreaOffset.
leftentero largoEl desplazamiento a la izquierda de la hoja desde la local.
topentero largoEl desplazamiento superior de la hoja desde el local.

Todas las propiedades son opcionales.

Protección de la hoja

Para bloquear toda la hoja, basta con poner la propiedad isProtected en true. A continuación, puede desbloquear las celdas individualmente colocando la propiedad de estilo de celda bloqueada.

PropiedadTipoDescripción
isProtectedbooleanEspecifica si las celdas de esta hoja que están marcadas como protegidas no se pueden editar.
protectionOptionsobjectValor que indica los elementos que desea que los usuarios puedan modificar. Si null : el parámetro protectionOptions se reinicia.
allowSelectLockedCellsbooleanEspecifica si el usuario puede seleccionar celdas bloqueadas, opcional. True por defecto.
allowSelectUnlockedCellsbooleanIndica si el usuario puede seleccionar las celdas no bloqueadas, opcional. True por defecto.
allowSortbooleanEspecifica si el usuario puede ordenar rangos, opcional. Falso por defecto.
allowFilterbooleanEspecifica si el usuario puede filtrar rangos, opcional. Falso por defecto.
allowEditObjectsbooleanIndica si el usuario puede editar los objetos flotantes, opcional. Falso por defecto.
allowResizeRowsbooleanIndica si el usuario puede redimensionar las líneas, opcional. Falso por defecto.
allowResizeColumnsbooleanIndica si el usuario puede redimensionar las columnas, opcional. Falso por defecto.
allowDragInsertRowsbooleanEspecifica si el usuario puede realizar la operación de arrastre para insertar líneas, opcional. Falso por defecto.
allowDragInsertColumnsbooleanEspecifica si el usuario puede realizar la operación de arrastre para insertar columnas, opcional. Falso por defecto.
allowInsertRowsbooleanIndica si el usuario puede insertar las líneas, opcional. Falso por defecto.
allowInsertColumnsbooleanIndica si el usuario puede insertar las columnas, opcional. Falso por defecto.
allowDeleteRowsbooleanIndica si el usuario puede eliminar las líneas, opcional. Falso por defecto.
allowDeleteColumnsbooleanIndica si el usuario puede eliminar las columnas, opcional. Falso por defecto.

Todas las propiedades son opcionales.

Formato de las celdas

La definición de un modelo de formato garantiza que el contenido de sus documentos 4D View Pro se muestre de la forma que usted desea. Los formatos pueden definirse utilizando la interfaz 4D View Pro seleccionada, o utilizando los métodos VP SET VALUE o VP SET NUM VALUE.

4D View Pro tiene formatos integrados para números, fechas, horas y texto, pero también puede crear sus propios modelos para dar formato al contenido de las celdas utilizando caracteres y códigos especiales.

Por ejemplo, al utilizar los métodos VP SET VALUE o VP SET NUM VALUE para introducir las cifras en una factura, es posible que desee que los símbolos de moneda ($, €, ¥, etc.) se alineen independientemente del espacio requerido por el número (es decir, si el importe es de 5,00 $ o de 5.000,00 $). Podría utilizar caracteres de formato y espectificar el patrón ($* #,##0.00) que mostraría los importes como se muestra:

Tenga en cuenta que al crear sus propios formatos, sólo se modifica la visualización de los datos. El valor de los datos permanece sin cambios.

Formatos numérico y texto

Los formatos numéricos se aplican a todos los tipos de números (por ejemplo, positivos, negativos y ceros).

CaracterDescripciónEjemplo
0Marcador de posición que muestra ceros.#.00 mostrará 1.1 como 1.10
.Muestra un punto decimal0.00 mostrará 1999 como 1999.00
,Muestra el separador de miles en un número. Los miles se separan por comas si el formato contiene una coma encerrada por signos de número "#" o por ceros. Una coma a continuación de un marcador de posición de dígitos escala el número por 1.000.#,0 mostrará 12200000 como 12,200,000
_Salta el ancho del siguiente caracter.Suele utilizarse en combinación con paréntesis para añadir sangrías a izquierda y derecha, _( y _) respectivamente.
@Formateador de texto. Aplica el formato a todo el texto de la celda"[Red]@" aplica el color de fuente rojo para los valores de texto.
*Repite el siguiente caracter para llenar el ancho de la columna.0- incluirá suficientes guiones después de un número para llenar la celda, mientras que 0 antes de cualquier formato incluirá ceros a la izquierda.
" "Muestra el texto entre comillas sin interpretarlo."8%" será mostrado como: 8%
%Muestra los números como un porcentaje de 100.8% se mostrará como 0,08
#Marcador de posición de dígitos que no muestra ceros adicionales. Si un número tiene más dígitos a la derecha del decimal que marcadores de posición, el número se redondea.#.# mostrará 1.54 como 1.5
?Marcador de posición de dígitos que deja espacio para ceros adicionales, pero no los muestra. Normalmente se utiliza para alinear números por punto decimal.$?? $?? displays a maximum of 2 decimals and causes dollar signs to line up for varying amounts.
\ Muestra el caracter que lo sigue.#.00\? #.00\? will display 123 as 123.00?
/Cuando se utiliza con números, los muestra como fracciones. Cuando se utiliza con códigos de texto, fecha u hora, se muestra "tal cual".#/# mostrará .75 como 3/4
[ ]Crea formatos condicionales.[>100][GREEN]#,##0;[<=-100][YELLOW]#,##0;[BLUE]#,##0
EFormato notación científica.#E+# - mostrará 2E+6 en lugar de 1,500,500
[color]Formatea el texto o el número en el color especificado[Green]###.##[Red]-###.###

Ejemplo

//Definir el valor de la celda como $125,571.35
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_($* #,##0.00_)")

Formatos fecha y hora

4D View Pro ofrece las siguientes constantes para los modelos de fecha y hora ISO 8601:

ConstanteValorComentario
vk pattern full date time"fullDateTimePattern"ISO 8601 format for the full date and time in current localization. USA default pattern: "dddd, dd MMMM yyyy HH:mm:ss"
vk pattern long date"longDatePattern"ISO 8601 format for the full date in current localization. USA default pattern: "dddd, dd MMMM yyyy"
vk pattern long time"longTimePattern"ISO 8601 format for the time in current localization. USA default pattern: "HH:mm:ss"
vk pattern month day"monthDayPattern"ISO 8601 format for the month and day in current localization. USA default pattern: "MMMM dd"
vk pattern short date"shortDatePattern"Abbreviated ISO 8601 format for the date in current localization. USA default pattern: "MM/dd/yyyy"
vk pattern short time"shortTimePattern"Abbreviated ISO 8601 format for the time in current localization. USA default pattern: "HH:mm"
vk pattern sortable date time"sortableDateTimePattern"ISO 8601 format for the date and time in current localization which can be sorted. USA default pattern: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss"
vk pattern universal sortable date time"universalSortableDateTimePattern"ISO 8601 format for the date and time in current localization using UTC which can be sorted. USA default pattern: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'"
vk pattern year month"yearMonthPattern"ISO 8601 format for the month and year in current localization. USA default pattern: "yyyy MMMM"

Ejemplo

//Definir el valor de la celda como fecha y hora específicas
VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time";?14:30:10?;"format";vk pattern full date time))

Formato fecha y hora personalizados

Para crear sus propios patrones de fecha y hora, en su localización actual, puede utilizar combinaciones de los siguientes códigos:

Code
(no distingue entre mayúsculas y minúsculas)
DescripciónEjemplo
Fecha(January 1, 2019)
mNúmero de mes sin cero inicial1
mmNúmero de mes con cero precedente01
mmmNombre del mes, cortoJan
mmmmNombre del mes, longJanuary
dNúmero del día sin el cero inicial1
ddNúmero de días con cero precedente01
dddDía de la semana, cortoTue
ddddDía de la semana, largoTuesday
yyAño, formato corto19
yyyyAño, formato largo2019
Hora(2:03:05 PM)
hHora sin cero precedente. 0-232
hhHora con cero precedente. 00-2302
mMinutos sin cero inicial. 0-593
mmMinutos con cero precedente. 00-5903
sSegundos sin cero a la izquierda. 0-595
ssSegundo con cero precedente. 00-5905
[h]Tiempo transcurrido en horas14 (puede superar 24)
[mm]Tiempo transcurrido en minutos843
[ss]Tiempo transcurrido en segundos50585
AM/PMPeriodos del día. Se utiliza el fomato de 24 horas si se omite.PM

El código "m" se interpreta en función de su posición en el patrón. Si está inmediatamente después de 'h' o 'hh' o inmediatamente antes de 's' o 'ss', se interpretará como minutos, de lo contrario se interpretará como meses.

Símbolos adicionales

Además de los caracteres y códigos especiales descritos en las secciones anteriores, existen caracteres y símbolos adicionales que pueden utilizarse en sus patrones de formato. Estos caracteres y símbolos adicionales no requieren un \ o "" y no afectan a la interpretación del patrón de formato. Aparecen "tal cual" dentro del patrón.

CaracterDescripciónEjemplo
+ y -Signos más y menos### + ### = ###,###
( )Paréntesis izquierdo y derecho(-###.##)
:Dos puntoshh:mm:ss
^Circunflejo#\^#
'Apostrofe'######
{ }Paréntesis curvos{###,###,###}
< >Signos menor que y mayor que## >##
=Signo igual#+#=##
/Barra inclinada hacia adelante. Cuando se utiliza con números, los muestra como fracciones.mm/dd/yyyy
!Signo de exclamación$###.00!
&Ampersand"Hello" & "Welcome"
~Tilde~##
Caracter de espacio
Euro€###.00
£Libra esterlina£###.00
¥Yen japonés¥###.00
$Signo dólar$###.00
¢Signo de centavo.00¢

Atributos de impresión

Los atributos de impresión de 4D View Pro le permiten controlar todos los aspectos de la impresión de las áreas de 4D View Pro. Estos atributos son manejados por los siguientes comandos:

Columnas / Líneas

Los atributos de columna y línea se utilizan para especificar el inicio, el final y la repetición de columnas y líneas.

PropiedadTipoDescripción
columnEndentero largoThe last row to print in a cell range. Default value = -1 (all rows)
columnStartentero largoThe first row to print in a cell range. Default value = -1 (all rows)
repeatColumnEndentero largoLa última columna de un rango de columnas a imprimir a la izquierda de cada página. Default value = -1 (all rows)
repeatColumnStartentero largoLa primera columna de un rango de columnas a imprimir a la izquierda de cada página. Default value = -1 (all rows)
repeatRowEndentero largoLa última línea de un rango de líneas a imprimir en la parte superior de cada página. Valor por defecto = -1 (todas las líneas)
repeatRowStartentero largoLa primera línea de un rango de líneas a imprimir en la parte superior de cada página. Valor por defecto = -1 (todas las líneas)
rowEndentero largoThe last column to print in a cell range. Valor por defecto = -1 (todas las líneas)
rowStartentero largoLa primera línea a imprimir en un rango de celdas. Valor por defecto = -1 (todas las líneas)

Encabezados / Pies de página

Los atributos de encabezado y pie de página se utilizan para especificar texto o imágenes en las secciones de encabezado/pie de página izquierda, derecha y central.

PropiedadTipoDescripción
footerCentertextEl texto y el formato del pie de página central en las páginas impresas.
footerCenterImagepicture | text*La imagen para la sección central del pie de página.
footerLefttextEl texto y el formato del pie de página izquierdo en las páginas impresas.
footerLeftImagepicture | text*La imagen de la parte izquierda del pie de página.
footerRighttextEl texto y el formato del pie de página derecho en las páginas impresas.
footerRightImagepicture | text*La imagen de la parte derecha del pie de página.
headerCentertextEl texto y el formato del encabezado central en las páginas impresas.
headerCenterImagepicture | text*La imagen para la sección central del encabezado.
headerLefttextEl texto y el formato del encabezado izquierdo en las páginas impresas.
headerLeftImagepicture | text*La imagen de la sección izquierda del encabezado.
headerRighttextEl texto y el formato del encabezado derecho en las páginas impresas.
headerRightImagepicture | text*La imagen de la sección derecha del encabezado.

* Si utiliza el tipo texto, pase la ruta de archivo (absoluta o relativa) de la imagen. Si pasa una ruta relativa, el archivo debe estar situado junto al archivo de estructura de la base de datos. En Windows, la extensión del archivo debe ser indicada. No importa el tipo utilizado para establecer una imagen, la imagen en sí (no una referencia) se almacena en el área de 4D View Pro y es devuelta por VP Get print info.

Caracteres especiales

Los siguientes caracteres especiales permiten añadir o dar formato automáticamente a la información del encabezado y pie de página cuando se imprime el área de 4D View Pro.

CaracterDescripciónEjemploResult
&Caracter de escape(ver ejemplos más abajo)
PPágina actualprintInfo.headerLeft:="Esta es la página &P."Esta es la página 5.
NConteo de páginasprintInfo.headerLeft:="Hay &N páginas."Hay 10 páginas.
DFecha actual (formato yyyy/mm/dd)printInfo.headerLeft:="Es &D."Es 2015/6/19.
THora actualprintInfo.headerLeft:="Es &T."Es 16:30:36.
GImagenprintInfo.headerLeftImage:=smiley
printInfo.headerLeft:="&G"
STachadoprintInfo.headerLeft:="&SEsto es texto."Esto es texto.
USubrayadoprintInfo.headerLeft:="&UEsto es texto."Esto es texto. (Subrayado)
BNegritaprintInfo.headerLeft:="&BEsto es texto."Esto es texto.
IItálicaprintInfo.headerLeft:="&IEsto es texto."Esto es texto.
"Prefijo fuenteprintInfo.headerLeft:="&\"Lucida Console\"&14This is text."
KPrefijo de color de textoprintInfo.headerLeft:="&KFF0000Esto es texto."Esto es texto (en rojo).
FNombre del libroprintInfo.headerLeft:="&F"2019 Monthly Revenue Forecasts
ANombre de la hoja de cálculoprintInfo.headerLeft:="&A"June 2019 revenue forecast

Márgenes

Los atributos margen se utilizan para especificar los márgenes del área 4D View Pro para la impresión. Expresado en centésimas de pulgada.

PropiedadTipoDescripción
marginobjectLos márgenes de impresión
topentero largoMargen superior, en centésimas de pulgada. Por defecto = 75
bottomentero largoEl margen inferior, en centésimas del pulgada. Por defecto = 75
leftentero largoMargen derecho, en centésimas de pulgada. Por defecto = 70
rightentero largoMargen derecho, en centésimas de pulgada. Por defecto = 70
headerentero largoDesplazamiento del encabezado, en centésimas de pulgada. Por defecto = 30
footerentero largoDesplazamiento del pie de página, en centésimas de pulgada. Por defecto = 30

Orientación

Los atributos de orientación se utilizan para especificar la dirección del diseño de la página impresa.

Este atributo define sólo la información de renderizado.

PropiedadTipoDescripción
orientationentero largoOrientación de la página. Valores disponibles: vk print page orientation landscape, vk print page orientation portrait (por defecto)

Página

Los atributos página se utilizan para especificar la configuración general de impresión del documento.

PropiedadTipoDescripción
blackAndWhitebooleanImpresión sólo en blanco y negro.

Valor por defecto: false

Nota: los PDFs no se ven afectados por este atributo. Los colores en PDFs permanecen.

centeringentero largoComo se centran los contenidos en la página impresa. Valores disponibles: vk print centering both, vk print centering horizontal, vk print centering none (por defecto), vk print centering vertical
firstPageNumberentero largoEl número de página a imprimir en la primera página. Valor por defecto = 1
pageOrderentero largoLas páginas del pedido se imprimen. Valores disponibles: vk print page order auto (por defecto), vk print page order down then over, vk print page order over then down.
pageRangetextEl rango de páginas a imprimir
qualityFactorentero largoEl factor de calidad para la impresión (1 - 8). Cuanto mayor sea el factor de calidad, mejor será la calidad de impresión, aunque el rendimiento de la impresión puede verse afectado.

Por defecto = 2

useMaxbooleanSólo se imprimen columnas y líneas con datos.

Valor por defecto: true

zoomFactorrealLa cantidad para ampliar o reducir la página impresa.

Por defecto = 1

Tamaño del papel

Los atributos de tamaño de papel se utilizan para especificar las dimensiones o el modelo de papel que se utilizará para la impresión. Hay dos maneras de definir el tamaño del papel:

  • Tamaño personalizado - atributos de alto y ancho
  • Tamaño estándar - atributo kind
PropiedadTipoDescripción
paperSizeobjectDimensiones del papel (alto, ancho) o formato específico (tipo) para la impresión.
heightentero largoLa altura del papel, en centésimas del pulgada.
anchoentero largoAncho del papel, en centésimas de pulgada.
kindtextNombre del tamaño de papel estándar (por ejemplo, A2, A4, legal, etc.) devuelto por Get Print Option. Valor por defecto: "letter"
  • Si el tamaño del papel se especifica utilizando las propiedades height y width, VP Get print info devuelve un tamaño de papel con custom como valor para kind.

  • Si establece el tamaño del papel mediante la propiedad kind, puede utilizar cualquiera de los dos:

Escala

El atributo de escala se utiliza para la optimización y el ajuste de la impresión.

PropiedadTipoDescripción
bestFitColumnsbooleanEl ancho de la columna se ajusta para adaptarse al ancho del texto más grande para la impresión. Valor por defecto: "false"
bestFitRowsbooleanLa altura de la línea se ajusta a la altura del texto más alto para la impresión. Valor por defecto: "false"
fitPagesTallentero largoEl número de páginas verticales (orientación vertical) que hay que comprobar al optimizar la impresión. Por defecto = -1
fitPagesWideentero largoEl número de páginas horizontales (orientación horizontal) a comprobar cuando se optimiza la impresión. Por defecto = -1

Mostrar / Ocultar

Los atributos Mostrar / Ocultar se utilizan para especificar la visibilidad (impresión) de los elementos de área 4D View Pro.

PropiedadTipoDescripción
showBorderbooleanPrints the outline border. Default value = "true"
showColumnHeaderentero largoParámetros de impresión del encabezado de la columna. Valores disponibles: vk print visibility hide, vk print visibility inherit (por defecto), vk print visibility show, vk print visibility show once
showGridLinebooleanImprime las líneas de la cuadrícula. Valor por defecto: "false"
showRowHeaderentero largoParámetros de impresión de los encabezados de línea. Valores disponibles: vk print visibility hide, vk print visibility inherit (por defecto), vk print visibility show, vk print visibility show once

Marca de agua

Los atributos de marca de agua se utilizan para superponer texto o una imagen en el área de 4D View Pro.

PropiedadTipoDescripción
marca de aguacollectionColección de parámetros de marcas de agua. Valor por defecto: indefinido
[ ].heightentero largoLa altura del texto/imagen de la marca de agua.
[ ].imageSrcpicture | text*El texto/imagen de la marca de agua.
[ ].pagetextLa(s) página(s) donde se imprime la marca de agua. Para todas las páginas: "all". Para páginas específicas: números de página o rangos de páginas separados por comas. Ej.: "1,3,5-12"
[ ].widthentero largoEl ancho del texto/imagen marca de agua.
[ ].xentero largoLa coordenada horizontal del punto superior izquierdo del texto / imagen de la marca de agua.
[ ].yentero largoLa coordenada vertical del punto superior izquierdo del texto/imagen de la marca de agua.

* Si utiliza el tipo texto, pase la ruta de archivo (absoluta o relativa) de la imagen. Si pasa una ruta relativa, el archivo debe estar situado junto al archivo de estructura de la base de datos. En Windows, la extensión del archivo debe ser indicada. No importa el tipo utilizado para establecer una imagen, la imagen en sí (no una referencia) se almacena en el área de 4D View Pro y es devuelta por VP Get print info.

Objetos Estilo

Los objetos de estilo y las hojas de estilo de 4D View Pro le permiten controlar los aspectos gráficos y el aspecto de sus documentos 4D View Pro.

Objetos de estilo & Hojas de estilo

Los objetos Estilo contienen parámetros de estilo. Se pueden utilizar en una hoja de estilo o por su cuenta. Los objetos Estilo también pueden utilizarse además de una hoja de estilo, de modo que puedan definirse diferentes parámetros para rangos de celdas individuales sin que ello afecte al resto del documento. Puede utilizar objetos de estilo directamente con los comandos VP SET CELL STYLE y VP SET DEFAULT STYLE. También puede utilizar objetos de estilo al definir temas de tabla personalizados mediante los comandos VP SET TABLE THEME o VP CREATE TABLE.

Una hoja de estilo agrupa una combinación de propiedades en un objeto estilo para especificar el aspecto de todas las celdas de sus documentos 4D View Pro. Las hojas de estilo guardadas con el documento pueden utilizarse para definir las propiedades de una sola hoja, de varias hojas o de todo un libro de trabajo. Cuando se crea, una hoja de estilo 4D View Pro recibe un nombre que se guarda dentro de la hoja de estilo en la propiedad "name". Esto permite utilizar fácilmente una hoja de estilo y si se selecciona cuidadosamente, puede facilitar su identificación y finalidad (por ejemplo, Membrete_interno, Membrete_externo).

Las hojas de estilo se crean con el comando VP ADD STYLESHEET y se aplican con los comandos VP SET DEFAULT STYLE o VP SET CELL STYLE. Puede eliminar una hoja de estilo con el comando VP REMOVE STYLESHEET.

El comando VP Get stylesheet se puede utilizar para devolver el objeto de estilo de una única hoja de estilo o se puede utilizar el comando VP Get stylesheets para recuperar una colección de objetos de estilo para múltiples hojas de estilo.

Propiedades del objeto de estilo

Ejemplo:

 $style:=New object
$style.hAlign:=vk horizontal align left
$style.font:="12pt papyrus"
$style.backColor:="#E6E6FA" //color morado claro

VP SET DEFAULT STYLE("myDoc";$style)

Fondo & Primer plano

PropiedadTipoDescripciónValores posibles
backColortextDefine el color del fondo.Sintaxis de color CSS "#rrggbb" (sintaxis preferida), sintaxis de color CSS "rgb(r,g,b)" (sintaxis alternativa), nombre de color CSS (sintaxis alternativa)
backgroundImagepicture, textEspecifica una imagen de fondo.Puede especificarse directamente o a través de la ruta de la imagen (sólo ruta completa o nombre de archivo). Si sólo se utiliza el nombre del archivo, éste debe estar situado junto al archivo de estructura de la base. Independientemente de la configuración (imagen o texto), la imagen se guarda con el documento. Esto podría afectar al tamaño de un documento si la imagen es grande. Nota para Windows: la extensión del archivo incluirse.
backgroundImageLayoutentero largoDefine el diseño para la imagen de fondo.vk image layout center, vk image layout none, vk image layout stretch, vk image layout zoom
foreColortextDefine el color del primer plano.Sintaxis de color CSS "#rrggbb" (sintaxis preferida), sintaxis de color CSS "rgb(r,g,b)" (sintaxis alternativa), nombre de color CSS (sintaxis alternativa)

Bordes

PropiedadTipoDescripciónValores posibles
borderBottom, borderLeft, borderRight, borderTop, diagonalDown, diagonalUpobjectDefine la línea de borde correspondiente
colortextDefine el color del borde. Por defecto = black.Sintaxis de color CSS "#rrggbb" (sintaxis preferida), sintaxis de color CSS "rgb(r,g,b)" (sintaxis alternativa), nombre de color CSS (sintaxis alternativa)
styleentero largoDefine el estilo del borde. Por defecto = empty. No puede ser null o indefinido.vk line style dash dot, vk line style dash dot dot, vk line style dashed, vk line style dotted, vk line style double, vk line style empty, vk line style hair, vk line style medium, vk line style medium dash dot, vk line style medium dash dot dot,vk line style medium dashed, vk line style slanted dash dot, vk line style thick

Fuentes y texto

PropiedadTipoDescripciónValores posibles
fonttextEspecifica las características de la fuente en la abreviatura de fuentes CSS ("font-style font-variant font-weight font-size/line-height font-family"). Ejemplo: "14pt Century Gothic". Los valores font-size y font-family son obligatorios. Si falta alguno de los otros valores, se utilizan sus valores por defecto. Nota: si un nombre de fuente contiene un espacio, el nombre debe ir entre comillas.Una abreviatura de fuente CSS. 4D ofrece comandos utilitarios para manejar características de fuentes como objetos: VP Font to object y VP Object to font
formattertextPatrón de propiedad valor/tiempo.Formatos número/texto/fecha/hora, caracteres especiales. Ver Formato de celda.
isVerticalTextbooleanEspecifica la dirección del texto.True = texto vertical, False = texto horizontal.
labelOptionsobjectDefine las opciones de etiqueta de celda (opciones de marca de agua).
alignemententero largoEspecifica la posición de la etiqueta de la celda. Propiedad opcional.vk label alignment top left, vk label alignment bottom left, vk label alignment top center, vk label alignment bottom center, vk label alignment top right, vk label alignment bottom right
visibilityentero largoEspecifica la visibilidad de la etiqueta de la celda. Propiedad opcional.vk label visibility auto, vk label visibility hidden, vk label visibility visible
foreColortextDefine el color del primer plano. Propiedad opcional.Sintaxis de color CSS "#rrggbb" (sintaxis preferida), sintaxis de color CSS "rgb(r,g,b)" (sintaxis alternativa), nombre de color CSS (sintaxis alternativa)
fonttextEspecifica las características de la fuente con la abreviatura de fuentes CSS ("font-style font-variant font-weight font-size/line-height font-family"). Los valores font-size y font-family son obligatorios.
textDecorationentero largoEspecifica la decoración añadida al texto.vk text decoration double underline, vk text decoration line through, vk text decoration none, vk text decoration overline, vk text decoration underline
textIndententero largoDefine la unidad de indentación del texto. 1 = 8 píxeles
textOrientationentero largoDefine el ángulo de rotación del texto en una celda. Número entre -90 y 90
marca de aguatextDefine el contenido de la marca de agua (etiqueta de la celda)
wordWrapbooleanEspecifica si el texto debe ser ajustado.True = texto ajustado, False = texto no ajustado

Disposición

PropiedadTipoDescripciónValores posibles
cellPaddingtextDefine el relleno de la celda
hAlignentero largoDefine la alineación horizontal del contenido de la celda.vk horizontal align center, vk horizontal align general, vk horizontal align left, vk horizontal align right
lockedbooleanEspecifica el estado de protección de la celda. Nota, sólo está disponible si está activada la protección de hojas.True = bloqueado, False = desbloqueado.
shrinkToFitbooleanEspecifica si el contenido de la celda debe ser reducido.True = contenido reducido, False = sin reducción.
tabStopbooleanEspecifica si el foco de la celda se puede ajustar utilizando la tecla Tab.True = La tecla Tab define el foco, False = La tecla Tab no define el foco.
vAlignentero largoEspecifica la alineación vertical del contenido de la celda.vk vertical align bottom, vk vertical align center, vk vertical align top

Información de estilo

PropiedadTipoDescripción
nametextDefine el nombre del estilo
parentNametextEspecifica el estilo en el que se basa el estilo actual. Se aplicarán los valores del estilo padre y, a continuación, se aplicarán los valores del estilo actual. Los cambios realizados en el estilo actual no se reflejarán en el estilo principal. Sólo está disponible cuando se utiliza una hoja de estilo.

Objeto 4D View Pro

El objeto 4D View Pro almacena todo el contenido de la hoja de cálculo. Es manejado automáticamente por 4D View Pro. Puede definir u obtener este objeto utilizando los métodos VP IMPORT FROM OBJECT o VP Export to object.

Contiene las siguientes propiedades:

PropiedadTipo de valorDescripción
versionLongintVersión del componente interno
dateCreationTimestampFecha de creación
dateModifiedTimestampFecha última modificación
metaObjectContenido gratuito, reservado para el desarrollador 4D
spreadJSObjectReservado para el componente 4D View Pro

Variable de objeto de formulario 4D View Pro

La variable del objeto del formulario 4D View Pro es la variable del objeto asociada al área del formulario 4D View Pro. Gestiona la información utilizada por el objeto 4D View Pro.

La variable objeto del formulario 4D View Pro sólo tiene fines informativos (es decir, de depuración). Bajo ninguna circunstancia debe modificarse.

Contiene las siguientes propiedades:

PropiedadTipo de valorDescripción
ViewPro.areaTextNombre del área 4D View Pro
ViewPro.callbacksObjectAlmacena la información temporal necesaria para los comandos que requieren retrollamadas, como la importación y la exportación.
ViewPro.commandBuffersCollectionAlmacena secuencialmente los comandos llamados por el método y los ejecuta como un lote (en lugar de individualmente) al salir del método, o si un comando devuelve un valor o se llama a VP FLUSH COMMANDS. Este mecanismo aumenta el rendimiento al reducir el número de peticiones enviadas.
ViewPro.eventsObjectEvent list.
ViewPro.formulaBarBooleanIndica si se muestra o no la barra de fórmulas. Disponible sólo para la interfaz de la "barra de herramientas".
ViewPro.initedBooleanIndica si el área 4D View Pro ha sido inicializada o no (ver eventoOn VP Ready).
ViewPro.interfaceTextEspecifica el tipo de interfaz de usuario: "cinta", "barra de herramientas", "ninguna".