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