WP INSERT BREAK
WP INSERT BREAK ( objFaixa ; tipoRuptura ; modo {; atualizFaixa} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| objFaixa | Objeto | 🡒 | Objeto de faixa 4dWrite Pro |
| tipoRuptura | Inteiro longo | 🡒 | Tipo de quebra a inserir |
| modo | Inteiro longo | 🡒 | Modo de inserção |
| atualizFaixa | Inteiro longo | 🡒 | Modo de atualização da Faixa |
Descrição
O comando WP INSERT BREAK [#descv] insere uma nova ruptura de tipo tipoRuptura na faixa de seleção objFaixa segundo o modo de inserção modo e o parâmetro AtualizFaixa. [#descv]
Em objFaixa, passe:
- uma range, ou
- um elemento (tabela / fila / parágrafo / corpo / cabeçalho / rodapé / imagem inline / seção / subseção), ou
- um documento 4D Write Pro
Em tipoRuptura, passe uma das seguintes constantes do tema Constantes 4D Write Pro para definir o tipo de ruptura a inserir:
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| wk column break | Inteiro longo | 3 | Quebra de coluna: insere uma quebra de coluna |
| wk continuous section break | Inteiro longo | 5 | Define uma quebra de seção contínua (frequentemente usada para mudar o número de colunas sem começar uma nova página). |
| wk line break | Inteiro longo | 0 | Quebra de linha (no mesmo parágrafo) |
| wk page break | Inteiro longo | 2 | Quebra de página: define uma nova página |
| wk paragraph break | Inteiro longo | 4 | Quebra de parágrafo: define um novo parágrafo |
| wk section break | Inteiro longo | 1 | Quebra de seção: define uma nova seção |
No parâmetro modo, passe uma constante para indicar o modo de inserção que se utilizará para a ruptura na faixa de seleção objFaixa:
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| wk append | Inteiro longo | 2 | Insere conteúdos ao final da faixa e atualiza a faixa para conter tanto os conteúdos anteriores quanto os inseridos. |
| wk prepend | Inteiro longo | 1 | Conteúdos inseridos no início da faixa e atualiza a faixa para conter os conteúdos anteriores e os inseridos |
| wk replace | Inteiro longo | 0 | Substituir e atualizar conteúdos da faixa; a nova faixa contèm os conteúdos inseridos. |
- Se objRango for uma range, pode usar o ActRange opcional para passar uma das constantes abaixo para especificar se os conteúdos inseridos estão incluidos na range resultante:
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| wk exclude from range | Inteiro longo | 1 | Insere conteùdos ao fim da faixa e atualiza a faixa para menter apenas conteúdos anteriores. |
| wk include in range | Inteiro longo | 0 | Insere conteúdos ao início da faixa e atualiza a faixa para manter apenas conteúdos anteriores |
Se não passar o parâmetro ActFaixa, como padrão os conteúdos inseridos estão incluidos na faixa resultante.
- Se objRange não for uma range, ActRange é ignorado.
Exemplo 1
Ao criar faturas, se deseja inserir quebras de página, exceto na última página:
$nbInvoices:=Records in selection([INVOICE])
For($j;1;$nbInvoices)
... //Processamento de faturas
If($j#$nbInvoices) //Inserir uma quebra de página, exceto na última página
WP INSERT BREAK($buildRange;wk page break;wk append;wk exclude from range)
End if
End for
Exemplo 2
Se quiser inserir uma quebra de seção contínua para ter uma seção de uma coluna e uma seção de duas colunas na mesma página.
- Insira uma quebra de seção contínua na seleção para criar uma nova seção:
$range:=WP Selection range(*;"WParea")
WP INSERT BREAK($range;wk continuous section break;wk append)
2. Defina a contagem de colunas a 2 para a primeira seção:
$section:=WP Get section(WParea;1)
WP SET ATTRIBUTES($section;wk column count;2)
