Este é o site histórico da documentação 4D. As documentações estão sendo movidas progressivamente para developer.4d.com

Página Inicial

 
4D v19
Utilizar uma área 4D Write Pro

Utilizar uma área 4D Write Pro    


 

Nas aplicações 4D, os documentos, 4D Write Pro são criados importados e exportados por meio de comandos específicos que se encontram no tema 4D Write Pro (WP EXPORT DOCUMENT, WP EXPORT VARIABLE, WP Import document, WP New). 

Também é possível associar uma área 4D Write Pro com um campo Objeto em um formulário do banco de dados. Desta maneira, cada documento 4D Write Pro é automaticamente salvo com o registro e armazenado nos dados do banco de dados (ver Armazenar os documentos 4D Write Pro nos campos objeto 4D).

É possível salvar e reabrir documentos 4D Write Pro em disco e a partir de disco sem qualquer perda usando o formato nativo .4wp.

O formato .4wp consiste de uma pasta zip cujo nome é o título do documento e cujos conteúdos são texto HTML e imagens:

  • texto HTML combina HTML normal com expressões 4D (que não são computadas) assim como etiquetas 4D especificas,
  • imagens são armazenadas em uma pasta com o mesmo nome que o título do documento, do lado do arquivo HTML.

Já que documentos .4wp são baseados em HTML, podem ser importados ou abertos em qualquer aplicação externa que suporta HTML.

O formato de documento interno 4D Write Pro é uma extensão HTML proprietária, compatível comHTML5/XHTML5, mas que suporta um subconjunto de atributos HTML/CSS e etiquetas. Como resultado, apenas documentos HTML exportados por 4D Write Pro podem ser abertos por  4D Write Pro sem risco de perda de dados. Importar documentos HTML que foram criados externamente pode produzir erros.

Para saber mais,  baixe a lista de atributos 4D Write pro com definição associada como CSS style ou XHTML tag em 4D Write Pro XHTML.

Se a propriedade Menu contextual está selecionada por uma área 4D Write Pro (ver Criar uma área 4D Write Pro), um menu contextual completo está disponível para os usuários em modo Aplicação:

Este menu oferece acesso a todas as funcionalidades de 4D Write Pro.

Os documentos 4D Write Pro podem ser visualizados em três modos de vista de página:

  • Rascunho: modo rascunho com propriedades básicas
  • Página: modo "vista imprimir" (novo em 4D v15 R5)
  • Embebido: modo adequado para áreas embebidas, não exibe margens, cabeçalhos, rodapés, bordas de página, etc
    Este modo pode ser usado para produzir output do tipo Web (se selecionar também a resolução de 96 dpi e a opção HTML WYSIWYG).

O modo de visualização  pode ser  configurardo utilizando a área de menu pop-up:

Nota: o modo de visualização da página não são armazenadas com o documento.

Para áreas embebidas em formulários 4D, o modo vista pode ser também definido como padrão usando a lista Propriedades. Neste caso, o modo de vista é armazenado como uma propriedade do objeto de formulário 4D Write Pro (para saber mais, veja o parágrafo Configurar propriedades de Vista).

Quando o documento está no modo de vista Página, as seguintes propriedades do documento são mostradas ao usuário:

  • Traços de página para representar os limites de impressão
  • Largura de página e Altura da página (normal: 21x29.7 cm)
  • Orientação da página (normal: retrato)
  • Margem da página (normal: 2.5 cm)

Além disso, as novas propriedades de parágrafo estão disponíveis no submenu Parágrafo...:

  • Controle de viúvas e órfãs: quando esta opção estiver marcada para um parágrafo, 4D Write Pro não permitirá viúvas (última linha de um parágrafo isolado em um início da página) e órfãs (primeira linha de um parágrafo isolado em um fundo da página) no documento. No primeiro caso, a linha anterior se adicionará ao inicio da página de modo que duas linhas sao mostradas na parte superior página. No segundo caso, a primeira de uma só linha se move a seguinte página.
  • Evitar salto de página interior: quando esta opção estiver marcada para um parágrafo, 4D Write Pro evitará que o parágrafo seja rompido em partes de duas ou mais páginas.

Também pode utilizar os seguintes comandos desde o menu contextual:

  • Inserir salto de página: adiciona um  atributo de salto de página na posição do cursor. Se for selecionado um texto, se sustitui pelo salto de página.
  • Tamanho do documento.../Página: lhe permite selecionar um tamanho de página. Se propõe vários tamanhos de página normal
  • Orientação do documento.../Página: propriedade orientação normal (vertical/horizontal)

Nota: quando o documento está em modo Web ou Rascunho, as propriedades da página se podem definir, ainda que seu efeito não for visível. No modo Rascunho, os seguintes efeitos propriedad de parágrafo são visíveis:

  • Limitação de altura página (línhas desenhadas)
  • Colunas
  • Evitar salto de página dentro da propriedade
  • Controle  de viúdas e órfãs.     

Fundo  

O fundo de documentos 4D Write e elementos de documentos (tabelas, parágrafos, seções, cabeçalhos/rodapés, etc) podem ser estabelecidos com os efeitos abaixo:

  • cores
  • bordas
  • imagens
  • origem, posicionamento horizontal e vertical
  • área de pintura
  • repetir

Esses atributos podem ser definidos programaticamente para os elementos indivíduos ou uma página ou fundos de documentos inteiros com o comando WP SET ATTRIBUTES ou Usando ações padrão. Para ver a lista inteira de atributos de fundo disponíveis e onde podem ser aplicados, veja o artigo Atributos 4D Write Pro.  

Usuários podem modificar atributos de fundo via o menu contextual como mostrado abaixo:

Como exemplo de adicionar uma imagem de tamanho inteiro como fundo, veja How Do I (HDI) demo aqui.

Documentos 4D Write Pro são compatíveis com cabeçalhos e rodapés. Cabeçalhos e rodapés são relacionadas à seções

Uma seção é uma parte do documento definida por uma faixa de páginas e pode ter seu próprio paginamento e atributos comuns. Um documento pode conter qualquer número de seções (de uma seção ao número total de páginas). Cada página pode conter apenas uma seção.

Pode definir um conjunto de cabeçalhos e rodapés para cada seção

Seções são herdadas de atributos de documentos. Entretanto atributyos comuns de documentos, incluindo cabeçalhos e rodapés podem ser modificados separadamente para cada seção. O menu contextual pop up exibe as propriedades e atributos disponíveis ao nível de seção:

  • Orientação de Página: permite que estabeleça uma orientação de página específica  (Orientação vertical ou horizontal) por seção
  • Primeira página diferente: permite que estabeleça atributos diferentes para a primeira página da seção. Esta propriedade pode ser usada para criar páginas em branco no começo do texto, por exemplo. Quando este atributo estiver marcado, a primeira página da seção é manejada como uma subseção e pode ter seus próprios atributos.
  • Páginas da esquerda e da direita diferentes: permite que estabelece atributos diferentes para páginas que estão à esquerda e à direita na seção. Quando este atributo for marcado, páginas da esquerda e da direita na seção serão manejadas como subseções e terão seus próprios atributos.
  • Comandos Cabeçalho e Rodapé: estas opções permitem que defina cabeçalhos e rodapé separados. Estas opções são detalhadas abaixo
  • Margens / preenchimento / Bordas / Fundo: estes atributos podem ser definidos separadamente para cada seção. Para saber mais, veja o artigo Atributos 4D Write Pro.

Uma seção é um subconjunto de páginas contínuas em um documento 4D Write Pro. Um documento pode conter uma ou mais seções. Uma seção pode conter qualquer número de páginas, de uma página única ao número total de páginas do documento. Uma seção pode conter de uma coluna até 20 colunas.

Como padrão, um documento contém apenas uma seção, chamada Seção 1. O menu contextual 4D Write Pro exibe este número de seção sempre que clicar no documento.

Pode criar uma nova seção adicionado uma quebra de sessão no fluxo do texto :

Quando uma quebra de seção for adicionada, o menu contextual exibe um número incrementado para cada seção. No entanto, pode renomear qualquer seção:

O nome que digitar será usado como nome da seção em qualquer ponto do documento

Note que se tiver definido uma primeira página diferente ou a opção de páginas da esquerda e da direita diferentes para a seção, o tipo de página também é exibido no menu (ver abaixo)

Cada seção pode ter cabeçalhos e rodapés específicos. São exibidos apenas quando o modo de vista da página do documento for  Page.

Dentro de uma seção, pode definir até três diferentes cabeçalhos ou rodapés, dependendo das opções ativadas:

  • primeira página,
  • páginas esquerda,
  • páginas direita.

Para criar um cabeçalho ou rodapé:

  1. Veja se o documento está no modo de vista Page.
  2. Dê duplo clique na área de cabeçalho ou rodapé da seção desejada para começar o modo editar.
    • A área cabeçalho está no topo da página:
    • A área rodapé está no fundo da página:

Pode entrar qualquer conteúdo estático, que será automaticamente repetido em cada página da seção (exceto para a primeira página, se ativado)

Pode inserir conteúdos dinâmicos tais como número de página ou contador de página usando o comando ST INSERT EXPRESSION  (para saber mais, veja o parágrafo Inserir documentos e expressões de página).

Nota: TAmbém é possível manejar cabeçalhos e rodapés por programação, usando comandos específicos como WP Get header ou WP Get footer

Quando um cabeçalho ou rodapé tiver sido definido para uma seção, pode configurar seus atributos comuns usando o menu contextual:

Para saber mais sobre  Margens, Preenchimento, Bordas, e atributos Fundo, veja a seção Atributos 4D Write Pro.

Pode remover a definição total do cabeçalho ou rodapé (conteúdos e atributos) selecionando os comandos  Remove header ou Remove footer no menu contextual.

4D Write Pro maneja cabeçalhos e rodapés de documentos convertidos do plug-in 4D Write com uma altura fixa

A expressão abaixo e propriedades também são compatíveis e convertidas do plugin 4D Write em cabeçalhos e rodapés:

  • número de página e variáveis de contador de página
  • primeira página diferenciada
  • páginas esquerda/direita diferenciadas

As réguas estão disponíveis em todos os modos de visualização de 4D Write Pro e têm as seguintes características:

  • Graduações em cm, mm, polegadas ou pt de acordo com a unidade de desenho atual definida no documento 4D Write Pro. Pode mudar as unidades de medida mediante o menu contextual ou modificando o atributo wk layout unit.
  • Símbolo de indentação de primeira linha
  • Símbolo de margem de parágrafo esquerdo
  • Símbolo de margem de parágrafo direito
  • Tabulações mostradas ao longo da borda inferior da régua
  • O contraste de cor visível representa as margens de página esquerda e direita

As réguas verticais estão disponíveis só no modo Página e possuem as características abaixo:

  • Graduações em cm, mm, polegadas ou pt segundo a unidade de desenho atual definida no documento 4D Write Pro. Pode mudar as unidades de medida utilizando o menu contextual ou modificando o atributo wk layout unit.
     
  • Contraste de cor visível que representa as margens superior e inferior da página.

Pode mudar o estado de visualização da régua marcando ou desmarcando a opção Mostrar régua horizontal ou Mostrar régua vertical no menu contextual da área 4D Write Pro:
 

 

Nota: uma propriedade específica da área 4D Write Pro permite definir a visualização predeterminada para as réguas (ver a seção Configurar propriedades de Vista).

É possível usar o menu contextual de regua para criar, modificar ou apagar tabulações:

Para criar uma tabulação, dê um clique direito diretamente na régua e escolha seu tipo do menu contextual; um clique esquerdo automaticamente cria uma aba esquerda padrão. Pode também dar um clique direito em tabulações existentes para modificar seu tipo usando o menu contextual.

Remover tabulação só está disponível quando der clique direito diretamente numa tabulação existente; também pode remover tabulações ao arrastar as tabulações fora da área de régua.

Notea: 

  • Abas também podem ser definidas por programação com os comandos WP SET ATTRIBUTES, WP GET ATTRIBUTES, e WP RESET ATTRIBUTES com os seletores wk tab default e wk tabs

  • Para separações decimais, 4D Write Pro consida o primeiro caractere ponto ou vírgula da direita como um separador decimal; essa configuração padrão pode ser modificada com o seletor wk tab decimal separator 

 

 

Os caracteres precedendo as tabulações (signos iniciais) podem ser definidos ao selecionar entre cinco caracteres pré-definidos ou definindo um caractere específico a usar. Os caracteres pré-definidos são:

  • Nenhum (nenhum caractere é exibido - padrão)
  • ....      (pontos)
  • ---      (traços)
  • __     (subscritos)
  • ***     (asteriscos)

Signos iniciais sempre aparecem antes da aba e seguem a direção do texto (da esquerda para direita ou direita para esquerda). Podem ser definidos por programação com  os comandos WP SET ATTRIBUTES, WP GET ATTRIBUTES, e WP RESET ATTRIBUTES usando wk leading com os seletores wk tab default ou wk tabs , ou através do menu contextual da régua horizontal (mostrado abaixo).

Quando Outro... for selecionado, um diálogo é exibido onde um caractere inicial personalizado pode ser definido.

Pode modificar margens, indentações e posições de abas clicando e arrastando os símbolos correspondentes:

Quando colocar o mouse sobre um destes símbolos, o cursor muda para indicar que pode ser movido e aparece uma linha de guia vertical enquanto for arrastado:

Quando forem selecionados vários parágrafos, arrastar margens ou símbolos de indentação aplica estes margens ou indentações a todos os parágrafos selecionados. Mantendo pressionada a tecla Maiúsc Enquanto arrasta estes símbolos mantém os intervalos existentes entre indentações ou margens nos parágrafos selecionados.

Pode modificar margens esquerda e direita, indentações e posições de tabulação clicando e arrastando os símbolos correspondentes na régua horizontal:

Quando colocar o mouse sobre um desses símbolos, o cursor muda para indicar que pode ser movido e aparece uma linha de guia  vertical enquanto for arrastado:
 

Quando vários parágrafos forem selecionados, arrastar margens ou símbolos de indentação aplica a estas margens ou indentações a todos os parágrafos selecionados. Mantendo pressionada a tecla Maiúscula (Shift) enquanto arrasta estes símbolos mantém os intervalos existentes entre as identações ou margens nos parágrafos selecionados.

Pode modificar as margens superior e inferior com a régua vertical. Quando mover o mouse sobre o limite da margem, o cursor muda para indicar que é possível mover, e aparece uma linha de guia horizontal enquanto for arrastado:
 
 

Esta ação pode ser usada para modificar o espaço entre a parte superior e inferior da página e o corpo e o cabeçalho e rodapé de um documento. 

Quando duas ou mais colunas forem definidas para o documento ou seção, a régua exibe uma área específica para cada coluna:

Nota: propriedade Multi-coluna não está disponível em modo Embedded.

Um evento de formulário On After Edit é ativado para objeto de área de formulário 4D Write Pro sempre que uma aba ou controle de margem for movido, adicionado ou apagado, seja arrastando ou usando o menu contextual

4D Write Pro permite que maneje colunas em seus documentos. Colunas são conectadas da coluna mais à esquerda até a mais à direita. Ou seja, quando digitar texto, o fluxo de texto vai começar preenchendo a coluna mais à esquerda e continuar com a coluna diretamente à direita até chegar ao final da página. Quando o final da página tiver sido alcançado, o fluxo de texto vai para a próxima página. Para poder balancear as configurações de páginas, 4D Write Pro permite que insira quebras de coluna.

Colunas podem ser definidas ao nível de documento (são exibidos no documento inteiro) ou no nível da seção (cada seção pode ter sua própria configuração de coluna).

Nota: Colunas são compatíveis apenas nos modos Page view e Draft view  (não são exibidos em modo Embedded e não são exportados por WP EXPORT DOCUMENT e formato wk web page complete ).

Colunas podem ser estabelecidas usando:

Pode estabelecer ou obter as propriedades abaixo e ações para colunas:

PropriedadeDescriçãoDocumento atributosAções padrão
Número de colunasPode definir até  20 colunas para o documento/seçãowk column countcolumnCount
Espaçamento de colunaEspaço entre colunas em pts, polegadas, ou cm. Note que todas as colunas vão ter o mesmo tamanho. Cada largura de coluna é automaticamente calculada por 4D Write Pro de acordo com o número de colunas, a largura de página e o espaçamentowk column spacingcolumnSpacing
Largura de coluna(atributo apenas leitura) Largura atual de cada coluna, ou seja, largura computadawk column width-
Estilo, cor e largura de colunaPode adicionar um separadador vertical (uma linha decorativa) entre as collunas. Essas opções permitem planejar o estilo de separador, cor e largura. Para remover o separador vertical, selecione None como estilo.wk column rule style, wk column rule color, wk column rule widthcolumnRuleStyle, columnRuleColor, columnRuleWidth
Inserir breakInsere uma quebra de colunawk column break, veja também WP INSERT BREAKinsertColumnBreak
Menu de Colunas Crie um sub-menu Colunas -colunas

Os documentos 4D Write Pro podem conter tabelas. As tabelas 4D Write Pro sãoi criadas e definidas por programação, mas seu conteúdo pode ser modificado e manejado pelo usuário. Vários atributos de tabelas 4D Write Pro são editáveis incluindo a altura da fila, o alinhamento, as margens, o estilo de texto, a cor ou as bordas.

Uma tabela 4D Write Pro pode conter até:

  • 1000 linhas
  • 300 colunas

As tabelas 4D Write Pro são criadas mediante uma chamada ao comando WP Table append row. Depois pode adicionar filas utilizando o comando .

Nota: um usuário pode criar uma tabela ao copiar e colar um seleção de células:

Conteúdos de células podem ser adicionados por programação usando o comando WP Table append row.

Quando uma tabela tiver sido criada, conteúdos de célula podem ser editados durante execução pelos usuários. Podem clicar nas células e selecionar, editar, copiar, colar, apagar texto ou imagens da mesma maneira que em parágrafos normais. Podem navegar pelas células usando a tecla Tab (Shift+Tab para navegar na direção oposta).

Usar a tecla Retorno de carro dentro de uma célula cria um novo parágrafo na célula.

Note que a largura de célula é fixa: quando um usuário digita texto ou cola uma imagem, a altura da linha é automaticamente estendida se necessário e o texto sofre quebras de linha automaticamente.:

Usuários podem selecionar colunas, linhas ou células e aplicar atributos disponíveis de estilo, cor, alinhamento de texto, etc, usando o menu de pop up embutido ou qualquer inteface personalizada. 4D Write Pro oferece diversos comandos para selecionar qualquer parte de uma tabela:

(*) Colunas não tem um equivalente em html. Em  4D Write Pro, um conjunto de colunas é na verdade um conjunto de células, oque significa que colunas tem a mesma prioridade que células.

Quando tiver selecionado um conjunto, pode aplicar qualquer atributo apropriado usando o comando WP SET ATTRIBUTES. Dentro de células, atributos são aplicados a parágrafos, caracteres ou imagens, dependendo de seus conteúdos. Por exemplo, pode estabelecer a altura, tamanho de fonte, borda, etc de tabelas ou céllulas de tabelas. Para saber mais, veja a seção  Atributos 4D Write Pro).

Quando atributos diferentes são aplicados a elementos concorrentes de uma tabela, uma ordem de prioridade é aplicada à renderização:

  1. Tabela é renderizada primeiro
  2. Linhas são renderizadas (sobrepujando atributos de tabela)
  3. Células ou colunas são renderizadas (sobrepujando atributos de linha).

A largura de colunas tabelas podem ser modificadas arrastando o separador de colunas para a esquerda ou direita. O cursor muda para indicar que pode ser movido horizontalmente e uma linha vertical é mostrada na régua: 

Redimensionar colunas gera um evento de formulário On After Edit.

Para redimensionar uma coluna, clique no separador de colunas e arraste para a esquerda ou direita. O tamanho mínimo de coluna é 8pts. Se a coluna adjacente à direita alcançar o tamanho mínimo, todas as colunas à direita serão movidas. Se a primeira coluna ou uma coluna adjacente à esquerda alcançar o tamanho mínimo, nenhuma mudança de redimensionamente acontecerá nesta direção.

Se apertar a tecla Shift enquanto redimensiona uma coluna, o tamanho da coluna adjacente à direita não será modificada.



Nota: A propriedade Editável pode ser ativada para o documento 4D Write Pro para permitir o redimensionamento de coluna.

Quando exibido em modos Page ou Draft (ou no contexto de impressão de documento), tabelas 4D Write Pro podem se dividir:

  • automaticamente, se a altura da tabela for maior que a altura disponível de página/coluna
  • dependendo das quebras de página/coluna estabelecidas por programação ou pelo usuário.

Tabelas só se separam entre linhas (parágrafos dentro nunca são quebrados).

Nota: a paginação de tabela é atualizada dinamicamente se a orientação ou número de coluna forem modificados.

Paginação de tabela pode ser controlada por programação ou pelo usuário. Ações disponíveis incluem:

  • inserir uma quebra de página em uma tabela:

Quando for inserida uma quebra de página ou uma quebra de coluna através da ação padrão ou do menu contextual, ela é adicionada antes dos conteúdos selecionados: a primeira fila da seleção é movida ao início da próxima página ou coluna. Por exemplo:

===>

Nota: Tabelas não podem ser quebradas em diferentes seções. Inserir uma quebra de seção em uma tabela vai mover a tabela inteira para a nova seção

 
 

 
PROPRIEDADES 

Produto: 4D
Tema: Utilizar uma área 4D Write Pro

 
CONTEÚDO DA PÁGINA 
 
HISTÓRIA 

Modificado: 4D v15 R2
Modificado: 4D v15 R3
Modificado: 4D v15 R5
Modificado: 4D v16
Modificado: 4D v16 R2
Modificado: 4D v16 R4
Modificado: 4D v17
Modificado: 4D v17 R2
Modificado: 4D v17 R4

 
ARTICLE USAGE

Referência 4D Write Pro ( 4D v19)