SetStructElemBBox

Taggad PDF, tillgänglighet

Beskrivning

Sätter /BBox-attributet (Layout-attributägare) på det strukturelement som för tillfället är öppet på taggstacken. Bounding boxen knyter en rektangulär region i user space-koordinater till strukturelementet, vilket används av tillgänglighetsverktyg och re-flow-motorer. Ekvivalent med att anropa AddTagAttribute med Owner=Layout, Name=BBox och en mellanslagsseparerad koordinatsträng

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

Parametrar

Left	Bounding boxens vänsterkant i user space-standardenheter (punkter, 1/72 tum)
Bottom	Bounding boxens undre kant
Right	Bounding boxens högerkant
Top	Bounding boxens övre kant

Returvärde

Returnerar 1 vid lyckat anrop. Returnerar 0 om inget dokument är öppet eller om ingen tagg för tillfället ligger överst på taggstacken

Anmärkningar

Anropa den här funktionen efter BeginTag eller BeginTagEx och före EndTag. Koordinaterna följer PDF:ens standardkoordinatsystem där origo ligger i sidans nedre vänstra hörn

Attributet /BBox är definierat i ISO 32000-1 §14.8.5.4 (Layout-attributägare). Det är särskilt användbart för strukturelementtyperna Figure, Form och Formula

Exempel

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;

Se även

AddTagAttribute, SetStructElemScope, BeginTag, EndTag