Compose

Mise en page, pagination, Form XObjects

Description

Méthode abstraite de TPDFlibDynamicComponent qui dessine un fragment du composant en coordonnées locales et signale ses bornes utilisées et son état de continuation

Syntaxe

Function TPDFlibDynamicComponent.Compose(
  Const Context: TPDFlibDynamicPageContext;
  Out ComposeResult: TPDFlibDynamicPageResult): Integer;
  Virtual; Abstract;

Paramètres

`Context.LibraryInstance`	Instance `TPDFlib` attachée par laquelle le fragment doit dessiner
`Context.PageNumber`	Numéro de la page de destination même si la bibliothèque sélectionne une page temporaire isolée pendant l'exécution du rappel
`Context.CompositionIndex`	Numéro à base 1 que le fragment reçoit lors de sa validation
`Context.DestinationLeft`, `Context.DestinationTop`	Position de l'emplacement de destination transmise par l'appel de composition
`Context.AvailableWidth`, `Context.AvailableHeight`	Taille naturelle de la toile du Form XObject englobant

Enregistrement de résultat

`HasContent`	True lorsque le fragment a dessiné du contenu visible
`HasMoreContent`	True lorsque le composant peut produire un autre fragment
`UsedWidth`, `UsedHeight`	Rectangle utilisé qui démarre à la coordonnée locale zéro et doit englober tout le contenu visible du composant

Remarques

Les résultats avec contenu exigent des valeurs UsedWidth et UsedHeight finies et positives, dans les limites de AvailableWidth et AvailableHeight Un résultat sans contenu n'est valide que lorsque

Un résultat sans contenu n'est valide que lorsque HasMoreContent vaut False et que les deux dimensions utilisées sont nulles

Le callback peut utiliser les API de dessin et de contenu mais ne doit pas changer de documents, de pages ni de conteneurs de dessin imbriqués

La sessione valida ComposeResult via ValidComposeResult avant toute décision de placement

Renvoyer zéro rejette la tentative sans valider l'état du composant ni de la destination ; les exceptions levées se propagent après que la session a nettoyé l'état temporaire

Valeurs de retour

`1`	Le résultat du fragment est soumis à validation et placement
`0`	La tentative est rejetée et aucun état du composant ni de la destination ne change

Voir aussi

TPDFlibDynamicComponent, TPDFlibDynamicPageContext, TPDFlibDynamicPageResult, ValidComposeResult, ComposeNextLayout, CloneComponent