ComposeDeferredPageLayers

Disposition des pages, graphiques vectoriels, flux de contenu

Description

Place chaque calque différé en file d'attente sur sa page cible selon un ordre stable de z-index croissant

Syntaxe

Delphi

Function TPDFlib.ComposeDeferredPageLayers: Integer;

ActiveX

Function PDFlib::ComposeDeferredPageLayers() As Long

DLL

int DLComposeDeferredPageLayers(int InstanceID);

Valeurs de retour

Renvoie le nombre de couches composées, ou 0 si aucune n'est en file, si l'enregistrement est actif, la page sélectionnée n'est pas la cible, ses dimensions ont changé ou un Form capturé manque

Remarques

La méthode trie les calques en attente selon l’indice z et l’ordre d’enregistrement

Les couches négatives sont insérées avant les flux d'origine par ordre croissant, tandis que les couches nulles et positives sont ajoutées après, également par ordre croissant

Chaque couche composée ajoute un flux contenant un placement de Form XObject, rendant le coût de composition indépendant du nombre d'opérations de dessin de la couche

La police sélectionnée, le calque de contenu actif, l'état du moteur de tracé et le paramètre de crénage sont restaurés après la composition

Une précondition échouée laisse la file disponible pour resélectionner la page cible ; un échec après mutation de page efface la file afin d'éviter un placement en double

Exemple

PDF.BeginDeferredPageLayer(-10);
DrawBackground(PDF);
PDF.EndDeferredPageLayer;

PDF.BeginDeferredPageLayer(10);
DrawForeground(PDF);
PDF.EndDeferredPageLayer;

if PDF.ComposeDeferredPageLayers<> 2 then
  HandleCompositionError;