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

PageNuméro de page de destination existant à base 1
Left, TopPosition de destination du coin supérieur gauche dans les unités courantes du document
Width, HeightTaille finie et positive de l'emplacement de destination qui devient aussi la taille de la toile naturelle
PlacementEnregistrement 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_ERRORLa 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_MORELe fragment a été validé et du contenu reste à produire
PDF_DYNAMIC_COMPONENT_COMPLETELe fragment a achevé la session ou la session était déjà achevée
PDF_DYNAMIC_COMPONENT_RETRYLa 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