SetTextFlowPaginationLines

Texto, Layout

Descrição

Define contagens mínimas independentes de linhas na parte inferior da caixa atual e no topo da próxima caixa

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 retornado por NewTextFlow

OrphanLines

Mínimo de linhas aceitas na parte inferior de uma caixa ou coluna incompleta

WidowLines

Mínimo de linhas preservadas para o topo da próxima caixa ou coluna

Valores de retorno

Retorna 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 1 como padrão e se aplicam apenas quando uma caixa dividiria o fluxo restante

Se a cauda tentativa é mais curta que WidowLines, o número necessário de linhas candidatas passa para a próxima caixa enquanto pelo menos OrphanLines permanecem na caixa atual

Se nenhum split puder satisfazer os dois limites, a chamada de desenho retorna 0 e deixa o cursor de fluxo inalterado para que o chamador possa oferecer uma região maior

A paginação armazena em cache os fins de linha candidatos atuais e mede no máximo a janela de viúva configurada além do split, evitando uma segunda composição de todo o fluxo restante

Veja também

SetTextFlowMinLines, DrawTextFlow, DrawTextFlowColumns, MeasureTextFlow