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