SetStructElemBBox

Tagged PDF, Accessibility

Description

Устанавливает атрибут /BBox (владелец атрибута Layout) для структурного элемента, открытого в данный момент в стеке тегов; ограничительная рамка связывает прямоугольную область в координатах пользовательского пространства со структурным элементом, что используется инструментами специальных возможностей и механизмами перекомпоновки; эквивалентно вызову AddTagAttribute с параметрами Owner=Layout, Name=BBox и строкой координат, разделенных пробелами

Syntax

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

Parameters

Left	Левый край ограничительной рамки в единицах пространства пользователя по умолчанию (точках, 1/72 дюйма)
Bottom	Нижний край ограничительной рамки
Right	Right edge of the bounding box.
Top	Верхний край ограничительной рамки

Return value

Returns 1 on success. Returns 0 if no document is open or no tag is currently open on the tag stack.

Remarks

Вызывайте эту функцию после BeginTag или BeginTagEx и перед EndTag; координаты следуют стандартной координатной системе PDF, где начало координат находится в левом нижнем углу страницы

The /BBox attribute is defined in ISO 32000-1 §14.8.5.4 (Layout attribute owner). It is particularly useful for Figure, Form, and Formula structure element types.

Example

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;