SetTextFlowPaginationLines

Texto, composição

Descrição

Define contagens mínimas de linhas independentes no fundo da caixa atual e no topo da caixa seguinte

Sintaxe

Delphi

Function TPDFlib.SetTextFlowPaginationLines(FlowID, OrphanLines, WidowLines: Integer): Integer;

ActiveX

Function PDFlib::SetTextFlowPaginationLines(FlowID As Long, OrphanLines As Long, WidowLines As Long) As Long

DLL

int DLSetTextFlowPaginationLines(int InstanceID, int FlowID, int OrphanLines, int WidowLines);

Parâmetros

FlowID

Handle de fluxo de texto devolvido por NewTextFlow

OrphanLines

Mínimo de linhas aceites no fundo de uma caixa ou coluna incompleta

WidowLines

Mínimo de linhas preservadas para o topo da caixa ou coluna seguinte

Valores devolvidos

Devolve 1 quando o fluxo é válido e ambos os mínimos são pelo menos 1, ou 0 sem alterar nenhum dos valores

Observações

Ambos os limites têm como predefinição 1 e aplicam-se apenas quando uma caixa dividiria o fluxo restante

Se a cauda provisória for mais curta do que WidowLines, o número necessário de linhas candidatas passa para a caixa seguinte, permanecendo pelo menos OrphanLines na caixa atual

Se nenhuma divisão puder satisfazer ambos os limites, a chamada de desenho devolve 0 e deixa o cursor de fluxo inalterado, para que o chamador possa oferecer uma região maior

A paginação coloca em cache os fins de linha candidatos atuais e mede, no máximo, a janela de linhas viúvas configurada para além da divisão, evitando um segundo esquema de todo o fluxo restante

Consulte também

SetTextFlowMinLines, DrawTextFlow, DrawTextFlowColumns, MeasureTextFlow