SetStructElemBBox

Tagged PDF, Barrierefreiheit

Beschreibung

Legt das Attribut /BBox (Attributinhaber Layout) für das aktuell im Tag-Stack geöffnete Strukturelement fest. Der Begrenzungsrahmen ordnet dem Strukturelement einen rechteckigen Bereich in Benutzerraumkoordinaten zu, den Barrierefreiheitswerkzeuge und Umbruch-Engines verwenden. Entspricht einem Aufruf von AddTagAttribute mit Owner=Layout, Name=BBox und einer durch Leerzeichen getrennten Koordinatenzeichenfolge

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

Parameter

Left	Linke Kante des Begrenzungsrahmens in Standardeinheiten des Benutzerraums (Punkte, 1/72 Zoll)
Bottom	Unterkante des Begrenzungsrahmens.
Right	Rechter Rand des Begrenzungsrahmens.
Top	Oberkante des Begrenzungsrahmens

Rückgabewert

Gibt bei Erfolg 1 zurück. Gibt 0 zurück, wenn kein Dokument geöffnet oder aktuell kein Tag im Tag-Stapel geöffnet ist.

Anmerkungen

Rufen Sie diese Funktion nach BeginTag oder BeginTagEx und vor EndTag auf. Die Koordinaten folgen dem PDF-Standardkoordinatensystem, dessen Ursprung sich links unten auf der Seite befindet

Das Attribut /BBox ist in ISO 32000-1 §14.8.5.4 (Attributinhaber Layout) definiert. Es ist besonders nützlich für Strukturelementtypen Figure, Form und Formula

Beispiel

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;

Siehe auch

AddTagAttribute, SetStructElemScope, BeginTag, EndTag