BeginPageUpdate

Sayfa düzeni

Açıklama

Seçili sayfada toplu çizim işlemi başlatır. Sonraki çizim çağrıları (metin, yollar, görüntüler, ek açıklamalar) tek bir toplu işlemde arabelleğe alınır ve eşleşen EndPageUpdate çağrısı yapıldığında sayfanın içerik akışına boşaltılır

Çok sayıda küçük çizim ilkelinden karmaşık bir sayfa oluştururken, özellikle önceden kaydedilmiş bir sayfayı düzenleme için yeniden açarken bunu kullanın. Toplu işleme, çağrı başına içerik akışı serileştirme yükünü önler ve ortaya çıkan sayfa içerik akışını küçük ve düzgün biçimli tutar

Sözdizimi

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Dönüş değerleri

0Başarısız — açık belge yok veya şu anda hiçbir sayfa seçili değil
1Toplu çizim işlemi başlatıldı

Açıklamalar

Her BeginPageUpdate çağrısı aynı sayfada bir EndPageUpdate çağrısıyla eşleştirilmelidir. NewPage tarafından yeni oluşturulmuş yepyeni bir sayfaya içerik eklerken çift kesinlikle gerekli değildir; bu durumda sayfa zaten "yazmaya açık" durumdadır. Çift gereklidir; daha önce kapatılmış bir sayfa yeniden açılırken (EndPage sonrasında veya belge yüklendikten sonra) içeriği değiştirmek bunu gerektirir

İç içe çağrılar desteklenmez — düzenlemek üzere farklı bir sayfa açmadan önce EndPageUpdate çağrısı yapın

Örnek

// Add a stamp on an existing page of a loaded document
PDF.LoadFromFile('contract.pdf', '');
PDF.SelectPage(1);
PDF.BeginPageUpdate;
  PDF.SetTextColor(0.8, 0, 0);
  PDF.SetFontSize(48);
  PDF.PrintText(150, 400, 'DRAFT');
PDF.EndPageUpdate;
PDF.SaveToFile('contract-stamped.pdf');

Ayrıca bkz

EndPageUpdate, SelectPage, NewPage, EndPage