SetTextFlowPaginationLines

文本、版面

描述

为当前盒子底部和下一个盒子顶部设置独立的最小行数

语法

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);

参数

FlowID

NewTextFlow 返回的文本流句柄

OrphanLines

不完整盒子或列底部接受的最少行数

WidowLines

为下一个盒子或列顶部保留的最少行数

返回值

流有效且两个最小值都至少为 1 时返回 1，否则返回 0 且不更改任何值

备注

两个限制默认均为 1，且仅在框需要拆分剩余流时应用

若暂定尾段短于 WidowLines，所需数量的候选行移到下一个框，同时当前框至少保留 OrphanLines 行

若没有分割能同时满足两个限制，绘制调用返回 0 并保持流游标不变，以便调用方提供更大的区域

分页会缓存当前候选行尾，并在分割点之后最多度量配置的寡行窗口，避免对整个剩余流进行第二次排版

另请参阅

SetTextFlowMinLines, DrawTextFlow, DrawTextFlowColumns, MeasureTextFlow