ComposeDeferredPageLayers

Diseño de página, gráficos vectoriales, flujos de contenido

Descripción

Coloca cada capa diferida en cola en su página de destino siguiendo un orden estable ascendente de índice z

Sintaxis

Delphi

Function TPDFlib.ComposeDeferredPageLayers: Integer;

ActiveX

Function PDFlib::ComposeDeferredPageLayers() As Long

DLL

int DLComposeDeferredPageLayers(int InstanceID);

Valores devueltos

Devuelve el número de capas compuestas, o 0 cuando no hay ninguna capa en cola, la grabación sigue activa, la página seleccionada no es la página de destino, han cambiado sus dimensiones o no está disponible un formulario capturado

Observaciones

El método ordena las capas en cola por índice z y secuencia de grabación

Las capas negativas se insertan antes de los flujos originales en orden ascendente; las de cero y positivas se añaden después también en orden ascendente

Cada capa compuesta añade un flujo con una colocación Form XObject, manteniendo el coste independiente del número de operaciones de dibujo de la capa

La fuente seleccionada, la capa de contenido activa, el estado del pintor y la configuración de interletraje se restauran después de la composición

Una condición previa fallida deja disponible la cola para que el llamador pueda volver a seleccionar la página de destino, mientras que un fallo posterior a la modificación de la página borra la cola para evitar una colocación duplicada

Ejemplo

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

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

if PDF.ComposeDeferredPageLayers<> 2 then
  HandleCompositionError;