BeginDeferredPageLayer

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

Descripción

Comienza a grabar operaciones de dibujo en una capa diferida del tamaño de la página asociada a la página seleccionada

Sintaxis

Delphi

Function TPDFlib.BeginDeferredPageLayer(ZIndex: Integer): Integer;

ActiveX

Function PDFlib::BeginDeferredPageLayer(ZIndex As Long) As Long

DLL

int DLBeginDeferredPageLayer(int InstanceID, int ZIndex);

Parámetros

ZIndexValor de apilamiento con signo utilizado al componer las capas en cola

Valores devueltos

Devuelve 1 cuando comienza la grabación, o 0 cuando no hay ninguna página seleccionada, está activa otra capa diferida, un Form XObject o un patrón de mosaico, las dimensiones de la página no son válidas, las capas en cola pertenecen a otra página o se ha alcanzado el límite de 1024 capas

Observaciones

Los valores z-index negativos se colocan bajo el contenido de página existente antes de la composición; los valores cero y positivos, por encima

Las capas con el mismo índice z conservan su orden de registro original

La página de destino se sigue mediante la identidad de su objeto indirecto, por lo que moverla no desvincula sus capas en cola

Llame a EndDeferredPageLayer después de dibujar la capa

Ejemplo

if PDF.BeginDeferredPageLayer(-100)= 1 then
begin
  PDF.SetFillColor(0.95, 0.95, 0.95);
  PDF.DrawBox(0, 0, PDF.PageWidth, PDF.PageHeight, 1);
  PDF.EndDeferredPageLayer;
end;