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
| 0 | Başarısız — açık belge yok veya şu anda hiçbir sayfa seçili değil |
|---|---|
| 1 | Toplu ç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