SetStructElemBBox

Tagged PDF, Přístupnost

Popis

Nastaví atribut /BBox (vlastník Layout) na strukturním elementu aktuálně otevřeném na zásobníku tagů. Ohraničující box přiřadí obdélníkovou oblast v souřadnicích user space ke strukturnímu elementu, což používají accessibility nástroje a re-flow enginy. Ekvivalent volání AddTagAttribute s Owner=Layout, Name=BBox a řetězcem souřadnic oddělených mezerou

Syntaxe

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

Parametry

Left	Levá hrana ohraničujícího boxu v jednotkách default user space (body, 1/72 palce)
Bottom	Dolní hrana ohraničujícího boxu
Right	Pravá hrana ohraničujícího boxu
Top	Horní hrana ohraničujícího boxu

Návratová hodnota

Při úspěchu vrací 1. Vrací 0, pokud není otevřený žádný dokument nebo žádný tag v zásobníku tagů

Poznámky

Tuto funkci volejte po BeginTag nebo BeginTagEx a před EndTag. Souřadnice následují výchozí PDF soustavu souřadnic, kde je počátek v levém dolním rohu stránky

The /BBox attribute is defined in ISO 32000-1 §14.8.5.4 (Layout attribute owner). It is particularly useful for Figure, Form, and Formula structure element types.

Příklad

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;

Viz také

AddTagAttribute, SetStructElemScope, BeginTag, EndTag