SetStructElemBBox

ملف PDF ذو بنية، إمكانية الوصول

الوصف

يضبط خاصية /BBox (مالك خصائص التخطيط) على عنصر البنية المفتوح حاليًا على رصة الوسوم. وتربط الخصيصة المستطيلة المحيطة منطقة مستطيلة بإحداثيات فضاء المستخدم بعنصر البنية، وتستخدمها أدوات إمكانية الوصول ومحركات إعادة التدفق. وتكافئ استدعاء AddTagAttribute مع Owner=Layout وName=BBox وسلسلة إحداثيات مفصولة بمسافات

الصيغة

Delphi

Function TPDFlib.SetStructElemBBox(Left, Bottom, Right, Top: Double): Integer;

ActiveX

Function PDFlib::SetStructElemBBox(Left As Double, Bottom As Double, Right As Double, Top As Double) As Long

DLL

int DLSetStructElemBBox(int InstanceID, double Left, double Bottom, double Right, double Top);

المعاملات

Left	الحافة اليسرى للصندوق المحيط بوحدات فضاء المستخدم الافتراضية (نقاط، 1/72 بوصة)
Bottom	الحافة السفلية للصندوق المحيط
Right	الحافة اليمنى للصندوق المحيط
Top	الحافة العلوية للصندوق المحيط

قيمة الإرجاع

تُرجع 1 عند النجاح، و0 إذا لم يكن هناك مستند مفتوح أو لا يوجد وسم مفتوح حاليًا على رصة الوسوم

ملاحظات

استدعِ هذه الدالة بعد BeginTag أو BeginTagEx وقبل EndTag. وتتبع الإحداثيات نظام الإحداثيات الافتراضي في PDF حيث يقع الأصل في أسفل يسار الصفحة

تُعرَّف خاصية /BBox في ISO 32000-1 §14.8.5.4 (مالك خصائص التخطيط). وهي مفيدة بشكل خاص لأنواع عناصر بنية Figure وForm وFormula

مثال

var
  ImgX, ImgY, ImgW, ImgH: Double;
begin
  // Draw an image and tag it as a Figure with its bounding box
  ImgX := 72; ImgY := 600; ImgW := 150; ImgH := 100;
  PDFlib.BeginTag('Figure', 'Product photo', '', '');
  PDFlib.SetStructElemBBox(ImgX, ImgY, ImgX + ImgW, ImgY + ImgH);
  PDFlib.DrawImageMatrix(ImgID, ImgX, ImgY, ImgW, ImgH, 0);
  PDFlib.EndTag;
end;

انظر أيضا

AddTagAttribute, SetStructElemScope, BeginTag, EndTag