SetStructElemBBox

标记 PDF、可访问性

描述

在标签栈当前打开的结构元素上设置 /BBox 属性（Layout 属性所有者）。该边界框将用户空间坐标中的矩形区域关联到结构元素，供无障碍工具和重排引擎使用。等同于调用 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