Configuración de las áreas de 4D View Pro
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
Using the area's property list, you can set 4D View Pro object properties such as Object Name, Variable or Expression, Appearance, Action, and Events.
Selección de una interfaz usuario
You can select the interface to use with your 4D View Pro form areas in the Property List, under Appearance:
You can also use the
userInterface
andwithFormulaBar
(only with the "toolbar" interface) JSON properties.
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)
Enabling the Toolbar interface displays the Show Formula Bar option. 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ña | Acciones | Interfaz Cinta | Interfaz Barra de herramientas |
---|---|---|---|
File | Gestión de archivos | X | |
Inicio | Apariencia del texto | X | X |
Insertar | Añadir elementos | X | X |
Fórmulas | Cálculos de fórmulas y librería | X | X |
Datos | Gestión de los datos | X | X |
Mostrar | Presentación visual | X | X |
Settings | Presentación de la hoja | X |
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. Some standard form events provide extended information in the object returned by the FORM Event
command when they are generated for 4D View Pro areas. 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ándar | Eventos 4D View Pro específicos y extendidos |
---|---|
On Load | On VP Ready |
On Getting Focus | On Clicked |
On Losing Focus | On Double Clicked |
On Unload | On 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
Propiedad | Tipo | Descripción | |
---|---|---|---|
allowCellOverflow | boolean | Especifica si los datos pueden desbordarse hacia las celdas vacías adyacentes. | |
sheetTabColor | string | Una cadena color utilizada para representar el color de la pestaña de la hoja, como "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc. | |
frozenlineColor | string | Una cadena color utilizada para representar el color de la línea congelada, como "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", "Acento 5", etc. | |
clipBoardOptions | entero largo | La opción portapapeles. Available values: 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 | |
rejilla | object | Las opciones de la línea de rejilla. | |
color | string | Una 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. | |
showVerticalGridline | boolean | Especifica si se debe mostrar la línea de la cuadrícula vertical. | |
showHorizontalGridline | boolean | Especifica si mostrar o no la línea de rejilla horizontal. | |
rowHeaderVisible | boolean | Especifica si el encabezado de la línea es visible. | |
colHeaderVisible | boolean | Especifica si el encabezado de la columna es visible. | |
rowHeaderAutoText | entero largo | Especifica si el encabezado de la linea muestra letras o números o está en blanco. Available values: vk header auto text blank , vk header auto text letters , vk header auto text numbers | |
colHeaderAutoText | entero largo | Especifica si el encabezado de la columna muestra letras o números o está en blanco. Available values: vk header auto text blank , vk header auto text letters , vk header auto text numbers | |
selectionBackColor | string | El color de fondo de la selección para la hoja. (formato RGBA preferido) | |
selectionBorderColor | string | El color del borde de la selección para la hoja. | |
sheetAreaOffset | object | Las opciones de sheetAreaOffset. | |
left | entero largo | El desplazamiento a la izquierda de la hoja desde la local. | |
top | entero largo | El desplazamiento superior de la hoja desde el local. |
Todas las propiedades son opcionales.
Protección de la hoja
To lock the whole sheet, you only need to set the isProtected property to true. You can then unlock cells individually by setting the locked cell style property.
Propiedad | Tipo | Descripción | |
---|---|---|---|
isProtected | boolean | Especifica si las celdas de esta hoja que están marcadas como protegidas no se pueden editar. | |
protectionOptions | object | Valor que indica los elementos que desea que los usuarios puedan modificar. Si null : el parámetro protectionOptions se reinicia. | |
allowSelectLockedCells | boolean | Especifica si el usuario puede seleccionar celdas bloqueadas, opcional. True por defecto. | |
allowSelectUnlockedCells | boolean | Indica si el usuario puede seleccionar las celdas no bloqueadas, opcional. True por defecto. | |
allowSort | boolean | Especifica si el usuario puede ordenar rangos, opcional. Falso por defecto. | |
allowFilter | boolean | Especifica si el usuario puede filtrar rangos, opcional. Falso por defecto. | |
allowEditObjects | boolean | Indica si el usuario puede editar los objetos flotantes, opcional. Falso por defecto. | |
allowResizeRows | boolean | Indica si el usuario puede redimensionar las líneas, opcional. Falso por defecto. | |
allowResizeColumns | boolean | Indica si el usuario puede redimensionar las columnas, opcional. Falso por defecto. | |
allowDragInsertRows | boolean | Especifica si el usuario puede realizar la operación de arrastre para insertar líneas, opcional. Falso por defecto. | |
allowDragInsertColumns | boolean | Especifica si el usuario puede realizar la operación de arrastre para insertar columnas, opcional. Falso por defecto. | |
allowInsertRows | boolean | Indica si el usuario puede insertar las líneas, opcional. Falso por defecto. | |
allowInsertColumns | boolean | Indica si el usuario puede insertar las columnas, opcional. Falso por defecto. | |
allowDeleteRows | boolean | Indica si el usuario puede eliminar las líneas, opcional. Falso por defecto. | |
allowDeleteColumns | boolean | Indica 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. Formats can be set using the selected 4D View Pro interface, or using the VP SET VALUE or VP SET NUM VALUE commands.
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.
For example, when using the VP SET VALUE or VP SET NUM VALUE commands to enter amounts in an invoice, you may want the currency symbols ($, €, ¥, etc.) to be aligned regardless of the space required by the number (i.e., whether the amount is $5.00 or $5,000.00). You could use formatting characters and spectify the pattern ($* #,##0.00) which would display amounts as shown:
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).
Caracter | Descripción | Ejemplo |
---|---|---|
0 | Marcador de posición que muestra ceros. | #.00 mostrará 1.1 como 1.10 |
. | Muestra un punto decimal | 0.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 |
E | Formato 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:
Constante | Valor | Comentario |
---|---|---|
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ón | Ejemplo | |
---|---|---|---|
Fecha | (January 1, 2019) | ||
m | Número de mes sin cero inicial | 1 | |
mm | Número de mes con cero precedente | 01 | |
mmm | Nombre del mes, corto | Jan | |
mmmm | Nombre del mes, long | January | |
d | Número del día sin el cero inicial | 1 | |
dd | Número de días con cero precedente | 01 | |
ddd | Día de la semana, corto | Tue | |
dddd | Día de la semana, largo | Tuesday | |
yy | Año, formato corto | 19 | |
yyyy | Año, formato largo | 2019 | |
Hora | (2:03:05 PM) | ||
h | Hora sin cero precedente. 0-23 | 2 | |
hh | Hora con cero precedente. 00-23 | 02 | |
m | Minutos sin cero inicial. 0-59 | 3 | |
mm | Minutos con cero precedente. 00-59 | 03 | |
s | Segundos sin cero a la izquierda. 0-59 | 5 | |
ss | Segundo con cero precedente. 00-59 | 05 | |
[h] | Tiempo transcurrido en horas | 14 (puede superar 24) | |
[mm] | Tiempo transcurrido en minutos | 843 | |
[ss] | Tiempo transcurrido en segundos | 50585 | |
AM/PM | Periodos 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.
Caracter | Descripción | Ejemplo |
---|---|---|
- y - | Signos más y menos | ### + ### = ###,### |
( ) | Paréntesis izquierdo y derecho | (-###.##) |
: | Dos puntos | hh: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.
Propiedad | Tipo | Descripción |
---|---|---|
columnEnd | entero largo | The last row to print in a cell range. Default value = -1 (all rows) |
columnStart | entero largo | The first row to print in a cell range. Default value = -1 (all rows) |
repeatColumnEnd | entero largo | La última columna de un rango de columnas a imprimir a la izquierda de cada página. Default value = -1 (all rows) |
repeatColumnStart | entero largo | La primera columna de un rango de columnas a imprimir a la izquierda de cada página. Default value = -1 (all rows) |
repeatRowEnd | entero largo | La ú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) |
repeatRowStart | entero largo | La 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) |
rowEnd | entero largo | The last column to print in a cell range. Valor por defecto = -1 (todas las líneas) |
rowStart | entero largo | La 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.
Propiedad | Tipo | Descripción |
---|---|---|
footerCenter | text | El texto y el formato del pie de página central en las páginas impresas. |
footerCenterImage | picture | text* | La imagen para la sección central del pie de página. |
footerLeft | text | El texto y el formato del pie de página izquierdo en las páginas impresas. |
footerLeftImage | picture | text* | La imagen de la parte izquierda del pie de página. |
footerRight | text | El texto y el formato del pie de página derecho en las páginas impresas. |
footerRightImage | picture | text* | La imagen de la parte derecha del pie de página. |
headerCenter | text | El texto y el formato del encabezado central en las páginas impresas. |
headerCenterImage | picture | text* | La imagen para la sección central del encabezado. |
headerLeft | text | El texto y el formato del encabezado izquierdo en las páginas impresas. |
headerLeftImage | picture | text* | La imagen de la sección izquierda del encabezado. |
headerRight | text | El texto y el formato del encabezado derecho en las páginas impresas. |
headerRightImage | picture | 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 matter the type used to set an image, the image itself (not a reference) is stored in the 4D View Pro area and is returned by 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.
Caracter | Descripción | Ejemplo | Result | |
---|---|---|---|---|
& | Caracter de escape | (ver ejemplos más abajo) | ||
P | Página actual | printInfo.headerLeft:="This is page &P." | Esta es la página 5. | |
N | Conteo de páginas | printInfo.headerLeft:="There are &N pages." | Hay 10 páginas. | |
D | Fecha actual (formato yyyy/mm/dd) | printInfo.headerLeft:="It is &D." | Es 2015/6/19. | |
T | Hora actual | printInfo.headerLeft:="It is &T." | Es 16:30:36. | |
G | Imagen | printInfo.headerLeftImage:=smiley printInfo.headerLeft:="&G" | ||
S | Tachado | printInfo.headerLeft:="&SThis is text." | ||
U | Subrayado | printInfo.headerLeft:="&UThis is text." | Esto es texto. (Subrayado) | |
B | Negrita | printInfo.headerLeft:="&BThis is text." | Esto es texto. | |
I | Itálica | printInfo.headerLeft:="&IThis is text." | Esto es texto. | |
" | Prefijo fuente | printInfo.headerLeft:="&\"Lucida Console\"&14This is text." | ||
K | Prefijo de color de texto | printInfo.headerLeft:="&KFF0000This is text." | Esto es texto (en rojo). | |
F | Nombre del libro | printInfo.headerLeft:="&F" | 2019 Monthly Revenue Forecasts | |
A | Nombre de la hoja de cálculo | printInfo.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.
Propiedad | Tipo | Descripción | |
---|---|---|---|
margin | object | Los márgenes de impresión | |
top | entero largo | Margen superior, en centésimas de pulgada. Por defecto = 75 | |
bottom | entero largo | El margen inferior, en centésimas del pulgada. Por defecto = 75 | |
left | entero largo | Margen derecho, en centésimas de pulgada. Por defecto = 70 | |
right | entero largo | Margen derecho, en centésimas de pulgada. Por defecto = 70 | |
header | entero largo | Desplazamiento del encabezado, en centésimas de pulgada. Por defecto = 30 | |
footer | entero largo | Desplazamiento 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.
Propiedad | Tipo | Descripción |
---|---|---|
orientation | entero largo | Orientación de la página. Available values: vk print page orientation landscape , vk print page orientation portrait (default) |
Página
Los atributos página se utilizan para especificar la configuración general de impresión del documento.
Propiedad | Tipo | Descripción |
---|---|---|
blackAndWhite | boolean | Impresión sólo en blanco y negro. Default value = false Note: PDFs are not affected by this attribute. Se mantienen los colores en los PDF. |
centering | entero largo | Como se centran los contenidos en la página impresa. Available values: vk print centering both , vk print centering horizontal , vk print centering none (default), vk print centering vertical |
firstPageNumber | entero largo | El número de página a imprimir en la primera página. Valor por defecto = 1 |
pageOrder | entero largo | Las páginas del pedido se imprimen. Available values: vk print page order auto (default), vk print page order down then over , vk print page order over then down . |
pageRange | text | El rango de páginas a imprimir |
qualityFactor | entero largo | El factor de calidad para la impresión (1 - 8). The higher the quality factor, the better the printing quality, however printing performance may be affected. Default value = 2 |
useMax | boolean | Only columns and rows with data are printed. Default value = true |
zoomFactor | real | The amount to enlarge or reduce the printed page. Default value = 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
Propiedad | Tipo | Descripción | |
---|---|---|---|
paperSize | object | Dimensiones del papel (alto, ancho) o formato específico (tipo) para la impresión. | |
height | entero largo | La altura del papel, en centésimas del pulgada. | |
ancho | entero largo | Ancho del papel, en centésimas de pulgada. | |
kind | text | Name of standard paper size (e.g., A2, A4, legal, etc.) returned by Get Print Option . Valor por defecto: "letter" |
If the paper size is specified using the
height
andwidth
properties,VP Get print info
returns a paper size withcustom
as value forkind
.If you set the paper size using the
kind
property, you can use either:- one of the formats in the SpreadJS format list
- one of the formats returned by the
PRINT OPTION VALUES
command. In that case,VP Get print info
returns the corresponding format with the height and width.
Escala
El atributo de escala se utiliza para la optimización y el ajuste de la impresión.
Propiedad | Tipo | Descripción |
---|---|---|
bestFitColumns | boolean | El ancho de la columna se ajusta para adaptarse al ancho del texto más grande para la impresión. Valor por defecto: "false" |
bestFitRows | boolean | La altura de la línea se ajusta a la altura del texto más alto para la impresión. Valor por defecto: "false" |
fitPagesTall | entero largo | El número de páginas verticales (orientación vertical) que hay que comprobar al optimizar la impresión. Por defecto = -1 |
fitPagesWide | entero largo | El 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.
Propiedad | Tipo | Descripción |
---|---|---|
showBorder | boolean | Prints the outline border. Default value = "true" |
showColumnHeader | entero largo | Parámetros de impresión del encabezado de la columna. Available values: vk print visibility hide , vk print visibility inherit (default), vk print visibility show , vk print visibility show once |
showGridLine | boolean | Imprime las líneas de la cuadrícula. Valor por defecto: "false" |
showRowHeader | entero largo | Parámetros de impresión de los encabezados de línea. Available values: vk print visibility hide , vk print visibility inherit (default), 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.
Propiedad | Tipo | Descripción | |
---|---|---|---|
marca de agua | collection | Colección de parámetros de marcas de agua. Valor por defecto: indefinido | |
[ ].height | entero largo | La altura del texto/imagen de la marca de agua. | |
[ ].imageSrc | picture | text* | El texto/imagen de la marca de agua. | |
[ ].page | text | La(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" | |
[ ].width | entero largo | El ancho del texto/imagen marca de agua. | |
[ ].x | entero largo | La coordenada horizontal del punto superior izquierdo del texto / imagen de la marca de agua. | |
[ ].y | entero largo | La 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 matter the type used to set an image, the image itself (not a reference) is stored in the 4D View Pro area and is returned by 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.
Style objects & Style sheets
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. You can use style objects directly with the VP SET CELL STYLE and VP SET DEFAULT STYLE commands. You can also use style objects when defining custom table themes using the VP SET TABLE THEME or VP CREATE TABLE commands.
A style sheet groups together a combination of properties in a style object to specify the look of all of the cells in your 4D View Pro documents. 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).
Style sheets are created with the VP ADD STYLESHEET command and applied with the the VP SET DEFAULT STYLE or VP SET CELL STYLE commands. You can remove a style sheet with the VP REMOVE STYLESHEET command.
The VP Get stylesheet command can be used to return the style object of a single style sheet or you can use the VP Get stylesheets command to retrieve a collection of style objects for multiple style sheets.
Propiedades del objeto de estilo
Ejemplo:
$style:=New object
$style.hAlign:=vk horizontal align left
$style.font:="12pt papyrus"
$style.backColor:="#E6E6FA" //light purple color
VP SET DEFAULT STYLE("myDoc";$style)
Background & Foreground
Propiedad | Tipo | Descripción | Valores posibles |
---|---|---|---|
backColor | text | Define 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) |
backgroundImage | picture, text | Especifica 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. |
backgroundImageLayout | entero largo | Define el diseño para la imagen de fondo. | vk image layout center , vk image layout none , vk image layout stretch , vk image layout zoom |
foreColor | text | Define 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
Propiedad | Tipo | Descripción | Valores posibles | |
---|---|---|---|---|
borderBottom, borderLeft, borderRight, borderTop, diagonalDown, diagonalUp | object | Define la línea de borde correspondiente | ||
color | text | Define 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) | |
style | entero largo | Define 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
Propiedad | Tipo | Descripción | Valores posibles | |
---|---|---|---|---|
font | text | Especifica 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 provides utility commands to handle font characteristics as objects: VP Font to object and VP Object to font | |
formatter | text | Patrón de propiedad valor/tiempo. | Formatos número/texto/fecha/hora, caracteres especiales. See Cell Format. | |
isVerticalText | boolean | Especifica la dirección del texto. | True = texto vertical, False = texto horizontal. | |
labelOptions | object | Define las opciones de etiqueta de celda (opciones de marca de agua). | ||
alignement | entero largo | Especifica 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 | |
visibility | entero largo | Especifica la visibilidad de la etiqueta de la celda. Propiedad opcional. | vk label visibility auto , vk label visibility hidden , vk label visibility visible | |
foreColor | text | Define 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) | |
font | text | Especifica 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. | ||
textDecoration | entero largo | Especifica 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 | |
textIndent | entero largo | Define la unidad de indentación del texto. 1 = 8 píxeles | ||
textOrientation | entero largo | Define el ángulo de rotación del texto en una celda. Número entre -90 y 90 | ||
marca de agua | text | Define el contenido de la marca de agua (etiqueta de la celda) | ||
wordWrap | boolean | Especifica si el texto debe ser ajustado. | True = texto ajustado, False = texto no ajustado |
Disposición
Propiedad | Tipo | Descripción | Valores posibles |
---|---|---|---|
cellPadding | text | Define el relleno de la celda | |
hAlign | entero largo | Define 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 |
locked | boolean | Especifica el estado de protección de la celda. Note, this is only available if sheet protection is enabled. | True = bloqueado, False = desbloqueado. |
shrinkToFit | boolean | Especifica si el contenido de la celda debe ser reducido. | True = contenido reducido, False = sin reducción. |
tabStop | boolean | Especifica 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. |
vAlign | entero largo | Especifica 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
Propiedad | Tipo | Descripción |
---|---|---|
name | text | Define el nombre del estilo |
parentName | text | Especifica 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
The 4D View Pro object stores the whole spreadsheet contents. Es manejado automáticamente por 4D View Pro. You can set or get this object using the VP IMPORT FROM OBJECT or VP Export to object commands.
Contiene las siguientes propiedades:
Propiedad | Tipo de valor | Descripción |
---|---|---|
version | Longint | Versión del componente interno |
dateCreation | Timestamp | Fecha de creación |
dateModified | Timestamp | Fecha última modificación |
meta | Object | Contenido gratuito, reservado para el desarrollador 4D |
spreadJS | Object | Reservado para el componente 4D View Pro |
Variable de objeto de formulario 4D View Pro
The 4D View Pro form object variable is the object variable associated to the 4D View Pro form area. 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:
Propiedad | Tipo de valor | Descripción |
---|---|---|
ViewPro.area | Text | Nombre del área 4D View Pro |
ViewPro.callbacks | Object | Almacena la información temporal necesaria para los comandos que requieren retrollamadas, como la importación y la exportación. |
ViewPro.commandBuffers | Collection | Stores sequentially the commands called by the method and executes them as a batch (rather than individually) when exiting the method, when a command returns a value, or when the VP FLUSH COMMANDS is called. Este mecanismo aumenta el rendimiento al reducir el número de peticiones enviadas. |
ViewPro.events | Object | Event list. |
ViewPro.formulaBar | Boolean | Indica si se muestra o no la barra de fórmulas. Disponible sólo para la interfaz de la "barra de herramientas". |
ViewPro.inited | Boolean | Indicates whether or not the 4D View Pro area has been initialized (see On VP Ready event). |
ViewPro.interface | Text | Especifica el tipo de interfaz de usuario: "cinta", "barra de herramientas", "ninguna". |