BeginPageUpdate

تخطيط الصفحة

الوصف

يبدأ معاملة رسم مجمعًا على الصفحة المحددة حاليًا. وتُخزن استدعاءات الرسم اللاحقة (نص ومسارات وصور وتعليقات توضيحية) في دفعة واحدة وتُغسل إلى تدفق محتوى الصفحة عند استدعاء EndPageUpdate موافق

استخدم هذا عند تجميع صفحة معقدة من عناصر رسم صغيرة كثيرة، خاصة عند إعادة فتح صفحة محفوظة سلفًا للتحرير. ويجنب التجميع عبء تسلسل تدفق المحتوى لكل استدعاء ويبقى تدفق محتوى الصفحة الناتج مضغوطًا وسليم التكوين

الصيغة

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

قيم الإرجاع

ملاحظات

يجب أن يقترن كل استدعاء BeginPageUpdate باستدعاء EndPageUpdate واحد على الصفحة نفسها. والاقتران ليس مطلوبًا بدقة عند إضافة محتوى إلى صفحة جديدة تمامًا أُنشئت للتو بـ NewPage؛ ففي تلك الحالة تكون الصفحة في حالة "مفتوحة للكتابة" سلفًا. أما الاقتران مطلوب عند إعادة فتح صفحة أُغلقت سلفًا (بعد EndPage أو بعد تحميل المستند) وتعديل محتواها

الاستدعاءات المتداخلة غير مدعومة — استدعِ EndPageUpdate قبل فتح صفحة مختلفة للتحرير

مثال

// 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');

انظر أيضا

EndPageUpdate, SelectPage, NewPage, EndPage