InsertFormObjectFromXObject - TPdf

Bu API girdisi tanımlayıcıları, imzaları, kod bloklarını ve PDF terimlerini özgün biçiminde korur.

Bileşen: TPdf · Birim: PDFium

Bir TPdfXObject içine sarılmış sayfanın TEK bir kopyasını bu belgenin geçerli sayfasına ekler ve çağıranın bunu konumlandırabilmesi / ölçekleyebilmesi / döndürebilmesi için FPDF_PAGEOBJECT döndürür

Söz dizimi

function InsertFormObjectFromXObject(XObject: TPdfXObject): FPDF_PAGEOBJECT;

Açıklama

InsertFormObjectFromXObject, v1.25.0 Form XObject yeniden kullanım API'sinin ikinci yarısıdır. CreateXObjectFromPage tarafından oluşturulan bir TPdfXObject handle'ı alır ve o XObject'e başvuran TEK bir FPDF_PAGEOBJECT'i THIS document's CURRENT page içine ekler. Her çağrı yeni bir page object ekler; böylece aynı XObject destination'ın birden çok sayfasında birden çok kez damgalanabilir — her damga alttaki page-content cache'i paylaşır, bu da watermark / template yoğun olsa bile dosya boyutunu düşük tutar

Döndürülen FPDF_PAGEOBJECT handle'ı, çağıranın damgayı sayfanın herhangi bir yerine yerleştirmek / ölçeklemek / döndürmek için FPDFPageObj_SetMatrix ya da TPdfMatrix yardımcılarını çağırmasına izin verir. Açık bir transform olmadan eklenen sayfa alt sol köşede 1:1 ölçeğinde durur; bu neredeyse hiçbir zaman istediğiniz şey değildir, bu yüzden UpdatePage çağırmadan önce her zaman bir matrix ayarlayın

nil başarısızlıkta döner (XObject nil, bu TPdf Active değil, current page yok). Eklemeden sonra page object'e sayfa sahip olur, XObject değil — XObject'i serbest bırakmak eklenen page object'i geçersiz kılmaz

Notlar

Hedef sayfa THIS TPdf'nin PageNumber değeriyle belirlenir. Önce PageNumber ayarlayın, sonra InsertFormObjectFromXObject çağırın
Damgayı konumlandırdıktan sonra UpdatePage çağırın ki PDFium sayfa content stream'ini yeniden render etsin
Aynı XObject'i N sayfaya damgalamak, N page content stream içinde N FPDF_PAGEOBJECT başvurusu üretir ve hepsi tek XObject tanımını işaret eder — alttaki içeriği N kez kopyalamaktan çok daha ucuzdur
XObject'in ömrü hedef page object'in ömründen daha kısa olabilir; bir kez eklendiğinde, referansına sayfa sahip olur

Örnek

uses FPdfMatrix;

var
  PageObj: FPDF_PAGEOBJECT;
  M: TPdfMatrix;
begin
  Pdf1.PageNumber := 3;
  PageObj := Pdf1.InsertFormObjectFromXObject(XObj);
  if PageObj <> nil then
  begin
    M := TPdfMatrix.Create;
    try
      M.Translate(100, 200);
      M.Scale(0.5, 0.5);
      M.Rotate(15);
      FPDFPageObj_SetMatrix(PageObj, M.AsMatrix);
    finally
      M.Free;
    end;
    Pdf1.UpdatePage;
  end;
end;

Ayrıca bkz.

CreateXObjectFromPage, UpdatePage, PageNumber