SetStructElemBBox

Tagged PDF, Accessibility

Description

Stelt het /BBox-attribuut (Layout-attribuuteigenaar) in op het structuurelement dat momenteel geopend is op de tag-stack; het begrenzingskader koppelt een rechthoekig gebied in gebruikersruimte-coördinaten aan het structuurelement, dat wordt gebruikt door toegankelijkheidstools en re-flow-engines; dit is gelijk aan het aanroepen van AddTagAttribute met Owner=Layout, Name=BBox en een door spaties gescheiden coördinatenreeks

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	Linkerrand van de begrenzingsdoos in standaard gebruikersruimte-eenheden (punten, 1/72 inch)
Bottom	Onderkant van de bounding box
Right	Rechterrand van het begrenzingskader
Top	Bovenrand van het omsluitende kader

Return value

Retourneert 1 bij succes; retourneert 0 als er geen document open is of als er momenteel geen tag open is op de tag-stack

Remarks

Roep deze functie aan na BeginTag of BeginTagEx en vóór EndTag; de coördinaten volgen het standaard PDF-coördinatenstelsel waarbij de oorsprong zich linksonder op de pagina bevindt

Het attribuut /BBox is gedefinieerd in ISO 32000-1 §14.8.5.4 (Layout-attribuuteigenaar); het is met name handig voor de structuurelementtypen Figure, Form en Formula

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;