ComposeNext
Mise en page, pagination, Form XObjects
Description
Compose un fragment dynamique à état dans un emplacement de page de destination selon la règle de mise en page par défaut et signale le placement final
Syntaxe
Function TPDFlibDynamicComponentSession.ComposeNext(Page: Integer;
Left, Top, Width, Height: Double;
Out Placement: TPDFlibDynamicPagePlacement): Integer;
Paramètres
Page | Numéro de page de destination existant à base 1 |
|---|---|
Left, Top | Position de destination du coin supérieur gauche dans les unités courantes du document |
Width, Height | Taille finie et positive de l'emplacement de destination qui devient aussi la taille de la toile naturelle |
Placement | Enregistrement de placement émis décrivant le fragment validé |
Remarques
L'appel construit ses options via CreateLayoutOptions(Width, Height) et transmet à ComposeNextLayout ; il hérite donc de la gestion de débordement dopReject, de l'alignement dhaLeft et dvaTop, de la pagination dppAllowSplit et d'aucun minimum d'espace de flux
Le rectangle utilisé doit tenir dans l'emplacement, car la politique de débordement par défaut rejette plutôt que de rogner ou de mettre à l'échelle
ComposeNextLayout pour le comportement complet de placement, de nouvelle tentative et de transformation
Exemple
repeat
Status := Session.ComposeNext(PageNumber, 36, 36, 540, 720,
Placement);
if Status = PDF_DYNAMIC_COMPONENT_MORE then
PageNumber := PDF.NewPage;
until Status <> PDF_DYNAMIC_COMPONENT_MORE;
Valeurs de retour
PDF_DYNAMIC_COMPONENT_ERROR | La validation de l'entrée, du rappel, de la géométrie, du débordement ou du placement a échoué sans validation d'état |
|---|---|
PDF_DYNAMIC_COMPONENT_MORE | Le fragment a été validé et du contenu reste à produire |
PDF_DYNAMIC_COMPONENT_COMPLETE | Le fragment a achevé la session ou la session était déjà achevée |
PDF_DYNAMIC_COMPONENT_RETRY | La règle de pagination ou d'espace de flux a différé l'essai non validé vers un autre emplacement |
Voir aussi
ComposeNextLayout, CreateLayoutOptions, TPDFlibDynamicComponentSession, Compose, Completed, CompositionCount