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（Layout attribute owner）。對 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