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を返しフローカーソルを変えないため、呼び出し元はより大きな領域を提示できます

ページネーションは現在の候補行末をキャッシュし、分割位置から設定された寡婦ウィンドウの範囲を最大限測るため、残りフロー全体の2回目のレイアウトを避けられます

関連項目

SetTextFlowMinLines, DrawTextFlow, DrawTextFlowColumns, MeasureTextFlow