4D View Pro Print Attributes

4D v19

Linguagem 4D View Pro

Os atributos de impressão 4D View Pro lhe permitem controlar todos os aspectos da impressão de áreas 4D View Pro. Estes atributos são manejados pelos comandos abaixo:

Colunas /Linhas

Os atributos de coluna e linha são utilizados para especificar o começo, o final e a repetição de colunas e linhas.

Propriedade	Tipo	Descrição
columnEnd	inteiro longo	a última coluna a imprimir em uma seleção de células. Valor normal = -1 (todas as colunas)
columnStart	inteiro longo	a primeira coluna a imprimir em uma seleção de células. Valor normal = -1 (todas as colunas)
repeatColumnEnd	inteiro longo	a primeira coluna de uma seleção de colunas a imprimir à esquerda de cada página. Valor normal = -1 (todas as colunas)
repeatColumnStart	inteiro longo	a primeira coluna de uma seleção de colunas a imprimir à esquerda de cada página. Valor normal = -1 (todas as colunas)
repeatRowEnd	inteiro longo	a última fila de uma seleção de filas a imprimir no topo de cada página. Valor normal = -1 (todas as colunas)
repeatRowStart	inteiro longo	a primeira fila de uma seleção de filas a imprimir na parte superior de cada página. Valor normal = -1 (todas as linhas)
rowEnd	inteiro longo	a última fila a imprimir en uma seleção de células. Valor normal = -1 (todas as linhas)
rowStart	inteiro longo	a primeira fila a imprimir en uma seleção de células. Valor normal = -1 (todas as linhas)

Cabeçalhos /Rodapés

Atributos cabeçalho e rodapé são usados para especificar textos ou imagens na esquerda direita e centro nas seções cabeçalho/rodapé.

Propriedade	Tipo	Descrição
footerCenter	text	O texto e formato do rodapé centrado nas páginas impressas.
footerCenterImage	picture \| text*	A imagem para seção centrada no rodapé.
footerLeft	text	O texto e formato do rodapé esquerdo em páginas impressas.
footerLeftImage	picture \| text*	A imagem para seção esquerda do rodapé.
footerRight	text	Texto e formato do rodapé direito nas páginas impressas.
footerRightImage	picture \| text*	A imagem para a seção direita do rodapé.
headerCenter	text	Texto e formato do cabeçalho centrado em páginas impressas.
headerCenterImage	picture \| text*	Imagem para seção central do cabeçalho.
headerLeft	text	Texto e formato do cabeçalho esquerdo em páginas impressas.
headerLeftImage	picture \| text*	Imagem para seção esquerda do cabeçalho.
headerRight	text	Texto e formato do cabeçalho dirito em páginas impressas.
headerRightImage	picture \| text*	A imagem para a seção direita do cabeçalho.

* Se usar tipo texto, passe a rota de arquivo (absoluto ou relativo) da imagem. Se passar uma rota relativa, o arquivo deve ser localizado do lado do arquivo de estrutura de banco de dados. Em windows, a extensão de arquivo deve ser indicada. Não importa o tipo usado para estabelecer uma imagem, a imagem em si (e não a referência) é armazenada na área 4D View Pro e é retornada por VP Get print info.

Caracteres especiais

Os caracteres especiais abaixo permitem a adição automática ou formatação de informação no cabeçalho e rodapé quando a área 4D View Pro for impressa.

Caractere	Descrição	Exemplo	Resultado
&	Escape character	(see examples below)
P	Current page	printInfo.headerLeft:="This is page &P."	Esta é a página 5.
N	Page count	printInfo.headerLeft:="There are &N pages."	Há 10 páginas.
D	Current date (yyyy/mm/dd format)	printInfo.headerLeft:="It is &D."	It is 2015/6/19.
T	Current time	printInfo.headerLeft:="It is &T."	It is 16:30:36.
G	Image	printInfo.headerLeftImage:=smiley printInfo.headerLeft:="&G"
S	Strikethrough	printInfo.headerLeft:="&SThis is text."	Isto é texto.
U	Underline	printInfo.headerLeft:="&UThis is text."	Isto é texto.
B	Bold	printInfo.headerLeft:="&BThis is text."	Isto é texto.
I	Italic	printInfo.headerLeft:="&IThis is text."	Isto é texto.
"	Font prefix	printInfo.headerLeft:="&\"Lucida Console\"Isto é texto."
K	Text Color prefix	printInfo.headerLeft:="&KFF0000This is text."	Isto é texto.
F	Workbook name	printInfo.headerLeft:="&F"	2019 Monthly Revenue Forecasts
A	Spreadsheet name	printInfo.headerLeft:="&A"	June 2019 revenue forecast

Margens

Atributos de margem são usados para especificar as margens da área 4D View Pro para impressão. Expresso em centésimos de polegada.

Exemplo:

printInfo.margin({top:75, bottom:75, left:20, right:20, header:10, footer:20})

Propriedade

Tipo

Descrição

margin

object

The print margins

Propriedade	Tipo	Descrição
top	longint	Margem superiro, em centésimos de polegada Default value = 75
bottom	longint	Margem inferior, em centésimos de polegada. Default value = 75
left	longint	Margem esquerda, em centésimos de polegada. Default value = 70
right	longint	Margem direita, em centésimos de polegada. Default value = 70
header	longint	Offset do cabeçalho em centésimos de polegada Default value = 30
footer	longint	Offset rodapé em centésimo de polegada. Default value = 30

Orientação

Atributos de orientação são usados para especificar a direção do layout de página impressa.

Nota: Este atributo define informação renderizada apenas.

Propriedade

Tipo

Descrição

orientation

longint

orientação de página

Constante	Valor	Comentário
vk print page orientation landscape	2	Orientação Paisagem
vk print page orientation portrait	1	Orientação Portrait (padrão)

Página

Atributos de página são usados para especificar configurações gerais de impressão de documentos.

Propriedade

Tipo

Descrição

blackAndWhite

boolean

Impressão em branco e preto apenas.

Default value = "false"

centering

longint

Como os conteúdos são cnetrados na página de impressão:

Constante	Valor	Comentário
vk print centering both	3	Impressão na página é centrada horizontal e verticalmente
vk print centering horizontal	1	Impressão é centrada horizontalmente na página.
vk print centering none	0	Imprimir não é centrado (padrão)
vk print centering vertical	2	Impressão é centrada verticalmente na página

firstPageNumber

longint

O número de página a imprimir na primeira página.

Default value = 1

pageOrder

longint

A ordem de páginas a imprimir:

Constante	Valor	Comentário
vk print page order auto	0	Ordem de impressão é determinada automaticamente (padrão)
vk print page order down then over	1	Páginas são impressas descendente, depois através
vk print page order over then down	2	Páginas são impressas através, e depois descendente.

pageRange

text

a seleção de páginas a imprimir

qualityFactor

longint

Fator de qualidade para impressão (1 - 8). Quanto maior o fator, melhor a qualidade de impressão, entretanto a performance de impressão pode diminuir.

Default value = 2

useMax

boolean

Apenas colunas e linhas com dados são impressas.

Default value = "true"

zoomFactor

real

O quanto vai aumentar ou diminuir a página impressa.

Default value = 1

Tamanho papel

Atributos de tamanho de papel são usados apra especificar as dimensões ou modelo de papel a usar para impressão. Há duas maneiras de definir o tamanho de papel:

Tamanho personalizado - atributos de altura e largura
Tamanho padrão - atributo tipo

Propriedade

Tipo

Descrição

paperSize

object

Dimensões de papel (altura, largura) ou formato específico (tipo) para impressão.

Propriedade	Tipo	Descrição
altura	longint	Altura do papel, em centésimos de polegada
largura	longint	Largura de papel, em centésimos de polegada
kind/tipo	text	Nome do tamanho padronizado de papel (exemplo, A2, A4, legal, etc.) retornado por GET PRINT OPTION. Default value = "letter"

Scale

Atributos Scale são usados para especificar otimização e ajustes de impressão.

Propriedade	Tipo	Descrição
bestFitColumns	boolean	Largura de coluna é ajustada para a largura de texto mais larga para impressão. Default value = "false"
bestFitRows	boolean	Altura Linha é ajustada para encaixar com a maior altura de texto para impressão. Default value = "false"
fitPagesTall	longint	O número de páginas verticais (orientação retrato) para marcar quando otimizar impressão. Default value = -1
fitPagesWide	longint	Número de páginas horizontais (orientação paisagem) para marcar quando otimizar impressão. Default value = -1

Mostrar/Esconder

Atributos Show / Hide são usados para especificar a visibilidade (impressão) dos elementos da área 4D View Pro.

Propriedade

Tipo

Descrição

showBorder

boolean

Imprime a borda externa.

Default value = "true"

showColumnHeader

longint

Configurações de impressão do cabeçalho de coluna

Constante	Valor	Comentário
vk print visibility hide	1	o cabeçalho não é visível
vk print visibility inherit	0	Herda as configurações da planilha (padrão)
vk print visibility show	2	o cabeçalho é visível em todas as páginas
vk print visibility show once	3	O cabeçalho é visível uma vez

showGridLine

boolean

Imprime as gridlines.

Default value = "false"

showRowHeader

longint

Configurações de impressão de cabeçalhos Linha

Constante	Valor	Comentário
vk print visibility hide	1	o cabeçalho não é visível
vk print visibility inherit	0	Herda as configurações da planilha (padrão)
vk print visibility show	2	o cabeçalho é visível em todas as páginas
vk print visibility show once	3	O cabeçalho é visível uma vez

Marca d´água

ATributos de marca dágua são usados para superimpôr um texto ou uma imagem sobre a área 4D View Pro.

Propriedade

Tipo

Descrição

watermark

collection

Coleção de configurações de marca dágua.

Valor normal: undefined

Propriedade	Tipo	Descrição
[ ].height	longint	A altura do texto/imagem de marca dágua.
[ ].imageSrc	picture \| text*	Texto ou imagem da marca dágua.
[ ].page	text	As páginas onde a marca d´água será impressa. Para todas as páginas: "all" Em páginas específicas: número de páginas ou seleção de páginas separadas por vírgulas. Ex.: "1,3,5-12"
[ ].width	longint	A largura do texto ou imagem de marca d´água.
[ ].x	longint	A coordenada horizontal do canto esquerdo superior do texto/imagem marca d´água.
[ ].y	longint	A coordenada vertical do canto esquerdo superiro do texto/imagem de marca d´água.

* Se usar tipo texto, passe a rota de arquivo (absoluta ou relativa) da imagem. Se passar uma rota relativa, o arquivo deve estar localizado do lado do arquivo de estrutura de banco de dados. Em Windows, a extensão arquivo deve ser indicada. Não importa o tipo usado para estabelecer uma imagem, a imagem em si (não a referência) é armazenada na área 4D View Pro e é retornada por VP Get print info.

Ver também

VP Get print info
VP SET PRINT INFO