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