SetStructElemBBox

PDF con tag, accessibilità

Descrizione

Imposta l'attributo /BBox (proprietario degli attributi Layout) sull'elemento di struttura attualmente aperto nello stack dei tag. Il riquadro di delimitazione associa all'elemento di struttura una regione rettangolare espressa in coordinate dello spazio utente, utilizzata dagli strumenti di accessibilità e dai motori di ridisposizione. Equivale a chiamare AddTagAttribute con Owner=Layout, Name=BBox e una stringa di coordinate separate da spazi

Sintassi

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

Parametri

LeftBordo sinistro del riquadro di delimitazione nelle unità predefinite dello spazio utente (punti, 1/72 di pollice)
BottomBordo inferiore del riquadro di delimitazione
RightBordo destro del riquadro di delimitazione
TopBordo superiore del riquadro di delimitazione

Valore restituito

Restituisce 1 in caso di successo, 0 se nessun documento o tag è attualmente aperto

Note

Chiamare questa funzione dopo BeginTag o BeginTagEx e prima di EndTag. Le coordinate seguono il sistema di coordinate PDF predefinito, con l'origine nell'angolo inferiore sinistro della pagina

L'attributo /BBox è definito in ISO 32000-1 §14.8.5.4 (proprietario degli attributi Layout). È particolarmente utile per i tipi di elemento di struttura Figure, Form e Formula

Esempio

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;

Vedere anche

AddTagAttribute, SetStructElemScope, BeginTag, EndTag