SetTextFlowPaginationLines

Texte, mise en page

Description

Définit des nombres minimaux de lignes indépendants au bas de la boîte courante et au sommet de la boîte suivante

Syntaxe

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

Paramètres

FlowID

Handle de flux de texte retourné par NewTextFlow

OrphanLines

Nombre minimal de lignes accepté au bas d'une boîte ou colonne incomplète

WidowLines

Nombre minimal de lignes préservé pour le sommet de la boîte ou colonne suivante

Valeurs de retour

Retourne 1 lorsque le flux est valide et que les deux minimums valent au moins 1, ou 0 sans modifier l'une ni l'autre valeur

Remarques

Les deux limites valent 1 par défaut et ne s'appliquent que lorsqu'une boîte doit scinder le flux restantSi la queue provisoire est plus courte que

Si la queue provisoire est plus courte que WidowLines, le nombre requis de lignes candidates passe à la boîte suivante tandis qu'au moins OrphanLines restent dans la boîte actuelle

Si aucune division ne peut satisfaire les deux limites, l'appel de dessin renvoie 0 et laisse le curseur de flux inchangé pour que l'appelant puisse proposer une région plus grande

La pagination met en cache les fins de lignes candidates actuelles et mesure au plus la fenêtre de veuves configurée au-delà de la coupure, évitant une seconde mise en page de tout le flux restant

Voir aussi

SetTextFlowMinLines, DrawTextFlow, DrawTextFlowColumns, MeasureTextFlow