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:

• WP Table get rows para obter um conjunto de linha
• WP Table get columns para obter um conjunto de colunas(*)
• WP Table get cells para obter um conjunto de células

(*) 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, e as linhasa também podem ser dividas. A paginação da tabela é atualizada dinamicamente se a orientação ou o número de coluna for modificado.

• Notas:
  Pode desativar divisões automáticas em tabelas usando atributos de tabela wk page break inside row / wk page break inside table (ver Atributos 4D Write Pro) ou as ações table/avoidPageBreakInside e row/avoidPageBreakInside (ver Usando ações padrão). 
• Quando uma linha de tabela e um parágrafo tem opções diferentes de quebra de página, as opções aplicadas às linhas tem precedência. POr exemplo quando um parágrafo permitir quebras de página, mas sua linha pai não permitir, a linha não será dividida..
•  

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:
  
  • comando WP INSERT BREAK
  • ação padrão insertPageBreak
  • opção Insert page break do menu contextual padrão

• inserir uma quebra de coluna em uma tabela:
  
  • comando WP INSERT BREAK
  • ação padrãoinsertColumnBreak
  • opção Insert column break do menu contextual

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: 

Só as tabelas no corpo de um documento podem ser divididas. Os cortes inseridos nas tabelas, cabeçalhos e rodapés são ignorados.
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
Os saltos dentro das linhas não estão permitidos quando estiver ativados as Linhas Carry-over

4D Write Pro lhe permite definir até cinco linhas de cabeçalho por tabela. As linhas de cabeçalho selecionadas se repetirão em cada coluna ou página quando ocorrer uma quebra de coluna ou de página.

Os cabeçalhos da tabela são as primeiras linhas da tabela. Para definir as linhas de cabeçalho pode

• utilizar a ação padrão headerRowCount (ver Usando ações padrão), o
• utilizar a ação WP SET ATTRIBUTES com wk header row count (em uma tabela, ver Tabelas), ou wk header (em uma linha, ver Filas e Colunas). 

Se designar mais de cinco linhas como cabeçalho (ou se resultar de uma inserção de linhas em um cabeçalho existente), 4D Write Pro só utiliza as cinco primeiras linhas como cabeçalho. Se eliminar as linhas definidas no cabeçalho, o número de linhas do cabeçalho diminui.

Pode atribuir um objeto fórmulaa como fonte de dados para uma tabela e acessar os valores resultantes desde a tabela usando Expressões com This (ver abaixo).  a fórmula da fonte de dados é processada por 4D Write Pro quando se calculam as fórmulas (por exemplo, quando abrir o documento, quando chamar ao comando WP COMPUTE FORMULAS, etc.). Esta função aproveita os contextos de dados (ver WP SET DATA CONTEXT).

Um design da tabela baseado em uma fonte de dados que contém as linhas abaixo:

Exemplo (Mostrar modo referências):

Quando se calculam as fórmulas, a linha do modelo se duplica automaticamente segundo seja necessário para que coincida com todas as entidades ou elementos da coleção devolvidos pela fórmula da fonte de dados:

Em qualquer caso, a intrução abaixo devolve o número real de linhas:

As tabelas baseadas em fontes de dados são compatíveis com linhas de arraste inferiores (carry over) que são mostradas automaticamente na parte inferior de cada página ou coluna quando a tabela for dividida em mais de uma página ou coluna. Uma linha de arraste pode mostrar informação adicional baseada nos elementos mostrados ou impressos anteriormente, graças à expressão This.previousItems (ver Expressões com This). Esta função permite, por exemplo, adicionar linhas  de subtotal.

As linhas de arraste são mostradas:

• quando uma tabela de fonte de dados não cabe em uma só página (ou coluna)
• na parte inferior da tabela
• na primeira página (ou primeira coluna) e em todas as demais exceto na última.

Importante: as linhas de arraste só estão disponíveis nas tabelas preenchidas por uma fórmula de fonte de dados que devolva uma coleção ou uma seleção de entidades não vazia e no modo de visualização de valores. Em todos os demais casos ou quando a fórmula da fonte de dados não tiver sido calculado, uma linha de arraste é mostrada como uma linha normal.

Para criar líinhas de arraste:

1. No modelo da tabela, adicione uma linha logo depois da linha do modelo e insira as fórmulas necessárias em seu  interior, utilizando, por ejemplo This.previousItems.
2. Ative a funcionalidade de arraste de linhas para seu documento. Pode:
   - utilizar a ação padrão bottomCarryOverRow (ver Usando ações padrão), ou
   - utilizar o comando WP SET ATTRIBUTES com o seletor de atributos wk bottom carry over row Tabelas. 

Nota: não se permitem quebras de página dentro das linhas quando a função de traspaso de línhas estiver ativada (ver Paginação de Tabelas). As opções correspondentes, se forem definidas, são ignoradas.

As tabelas baseadas em fontes de dados são compatíveis com uma ou várias Linahs de quebra de ordem que podem ser mostradas antes ou depois da linha repetida. As linhas de ruptura de ordem lhe ajudam a dividir visualmente os elementos da fonte de dados já ordenados na tabela em diferentes partes baseadas em um valor de fórmula calculado

Cada vez que mudar o valor da fórmula, se insere uma nova linha de ruptura. Portanto, para que as tabelas se mostram corretamente, a seleção de entidades (ou coleção) utilizada como fonte de dados da tabela deve estar ordenada em consequencia. Por exemplo, se quiser desgloses por países e cidades, a fonte de dados deve ser ordenada do seguinte modo: ds.people.all().orderBy("country asc, city asc")

o valor de ruptura se define mediante o atributo wk break formula. O valor deve ser una fórmula baseada em uma propriedade do elemento como "This.item.name'', do contrario o valor calculado pode não mudar nunca, o que faz que a fórmula de ruptura seja inútil. O atributo wk break formula se ignora se a tabela não tiver fonte de dados ou se a linha for um cabeçalho. Uma linha de ruptura deve ser adjacente à línha repetida (seja antes ou depois), ou a outra línha de interrupção, do contrario se ignora.

Graças à expressão This.breakItems pode utilizar esta funcionalidad,e por exemplo, para mostrar a media total das linhas repetidas dentro de una linha de interrupção. breakItems é um subconjunto avaliado da fonte de dados da tabela, seja uma seleção de entidades se a fonte de dados da tabela for uma seleção de entidades, ou uma coleção se a fonte de dados for uma coleção. Assim, dentro de uma linha de ruptura, pode escrever: This.breakItems.sum("salario")

Para criar líinhas de ruptura:

1. Ordene a fonte de dados com os niveis correspondentes às rupturas que quiser mostrar, por exemplo, ds.People.all().orderBy("continent asc, country asc, city asc")
2. Desenhe as linhas de ruptura na plantilla de tabela. Se as quebras forem encontradas depois da linha repetida, devem coincidir  com a ordem inversa da fonte de dados, e se for encontrada antes da linha repetida, deve coincidir com a mesma ordem da fonte de dados.
3. Defina o atributo wk break formula para as linhas selecionadas:

Quando usar a formula dentro da tabela, a palavra chave This dá cesso a diferentes dados de acordo com o contexto:

Em outros contextos, essas expresões retornam undefined.

Nota: Para saber mais, veja inserção de fórmula  WP INSERT FORMULA.

Quando preencher uma tabela desde uma fonte de dados, as filas são criadas automaticamente quando calcular as referências. As linhas podem ser inseridas ou eliminadas, editar o conteúdo das células, mudar o estilo, etc:

Entretanto, lembre que se a fonte de dados da tabela voltar a ser calculada, qualquer modificação realizada nas linhas calculadas (exceto na primeira linha, ver a seguir) é perdida. Por outro lado, como a primeira linha é a linha da planilha, qualquer modificação realizada nesta linha se propagará a todas as linhas se voltar a calcular a fonte de dados da tabela. O mesmo é válido para quebra de linhas, qualquer modificação feita em quebras de linhas é perdida, exceto para quebras de linha template (que estao localizadas no final ou começo da tabela).

Por exemplo

Depois de voltar a calcular as expressões:

Quando o cursor se inserir em uma célula de uma tabela preenchida com uma fonte de dados, aparece um ícone no canto esquerdo junto com um conselho que mostra a informação:

Quando as fórmulas são mostradas como referências ou quando se guarda o documento, só são mostradas/salvas a primeira fila como planilha (se as fórmulas não estiverem congeladas).

Quando congelar as fórmulas, a tabela se converte em uma tabela padrão se restabelece a fonte de dados da tabela.

Nota: a ação padrão freezeExpressions não recalcula as fórmulas.