BeginDeferredPageLayer

Układ strony, Grafika wektorowa, Strumienie zawartości

Opis

Rozpoczyna rejestrowanie operacji rysowania w odroczonej warstwie o rozmiarze strony, powiązanej z wybraną stroną

Składnia

Delphi

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

ActiveX

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

DLL

int DLBeginDeferredPageLayer(int InstanceID, int ZIndex);

Parametry

Wartości zwracane

Zwraca 1, gdy rozpocznie się rejestrowanie, albo 0, gdy nie wybrano strony, aktywna jest inna warstwa odroczona, Form XObject lub wzorzec kafelkowy, wymiary strony są nieprawidłowe, oczekujące warstwy należą do innej strony albo osiągnięto limit 1024 warstw

Uwagi

Ujemne wartości indeksu z umieszczają warstwy pod zawartością strony istniejącą przed złożeniem, natomiast wartości zerowe i dodatnie umieszczają je nad tą zawartością

Warstwy o tym samym indeksie z zachowują pierwotną kolejność rejestrowania

Strona docelowa jest śledzona według tożsamości jej obiektu pośredniego, dlatego przeniesienie strony nie odłącza jej oczekujących warstw

Po narysowaniu warstwy wywołaj EndDeferredPageLayer

Przykład

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;