SetStructElemBBox

Tagged PDF, Tilgængelighed

Beskrivelse

Indstiller attributten /BBox (Layout-attributindehaver) på det strukturelement, der aktuelt er åbent på tagstakken. Afgrænsningsboksen knytter et rektangulært område i brugerrumskoordinater til strukturelementet, hvilket bruges af tilgængelighedsværktøjer og ombrydningsmotorer. Svarer til at kalde AddTagAttribute med Owner=Layout, Name=BBox og en mellemrumssepareret koordinatstreng.

Syntaks

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

Parametre

Left	Afgrænsningsboksens venstre kant i standardenheder for brugerrummet (punkter, 1/72 tomme).
Bottom	Afgrænsningsrammens nederste kant
Right	Afgrænsningsrammens højre kant
Top	Afgrænsningsrammens øverste kant.

Returværdi

Returnerer 1 ved succes. Returnerer 0, hvis intet dokument er åbent, eller intet tag aktuelt er åbent på tagstakken

Bemærkninger

Kald denne funktion efter BeginTag eller BeginTagEx og før EndTag. Koordinaterne følger PDF-standardkoordinatsystemet, hvor udgangspunktet er nederst til venstre på siden.

Attributten /BBox er defineret i ISO 32000-1 §14.8.5.4 (Layout-attributindehaver). Den er særligt nyttig for strukturelementtyperne Figure, Form og Formula.

Eksempel

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 også

AddTagAttribute, SetStructElemScope, BeginTag, EndTag