SetStructElemBBox

PDF balisé, accessibilité

Description

Définit /BBox (propriétaire Layout) sur l’élément ouvert. Le cadre associe une région rectangulaire en coordonnées utilisateur à l’élément pour les outils d’accessibilité et moteurs de redistribution. Équivaut à AddTagAttribute avec Owner=Layout, Name=BBox et une chaîne de coordonnées séparées par des espaces

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

Paramètres

Left	Bord gauche du cadre englobant en unités de l'espace utilisateur par défaut (points, 1/72 pouce)
Bottom	Bord inférieur de la boîte englobante
Right	Bord droit de la boîte englobante
Top	Bord supérieur de la boîte englobante

Valeur de retour

Renvoie 1 en cas de réussite Renvoie 0 si aucun document n'est ouvert ou si aucune balise n'est actuellement ouverte sur la pile de balises

Remarques

Appelez cette fonction après BeginTag ou BeginTagEx et avant EndTag. Les coordonnées suivent le système PDF par défaut, dont l’origine se trouve en bas à gauche de la page

L’attribut /BBox est défini dans ISO 32000-1 §14.8.5.4 (propriétaire d’attribut Layout). Il est particulièrement utile pour les types d’éléments de structure Figure, Form et Formula

Exemple

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;

Voir aussi

AddTagAttribute, SetStructElemScope, BeginTag, EndTag