SetStructElemBBox
Tagged PDF, Dostępność
Opis
Ustawia atrybut /BBox (właściciel atrybutów Layout) w elemencie struktury aktualnie otwartym na stosie tagów. Prostokąt ograniczający wiąże prostokątny obszar we współrzędnych przestrzeni użytkownika z elementem struktury i jest używany przez narzędzia dostępności oraz mechanizmy zmiany układu. Odpowiada wywołaniu AddTagAttribute z Owner=Layout, Name=BBox i ciągiem współrzędnych rozdzielonych spacjami
Składnia
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 LongDLL
int DLSetStructElemBBox(int InstanceID, double Left, double Bottom, double Right, double Top);Parametry
| Left | Lewa krawędź prostokąta ograniczającego w domyślnych jednostkach przestrzeni użytkownika (punkty, 1/72 cala) |
|---|---|
| Bottom | Dolna krawędź prostokąta ograniczającego |
| Right | Prawa krawędź prostokąta ograniczającego |
| Top | Górna krawędź prostokąta ograniczającego |
Wartość zwracana
Zwraca 1 w przypadku powodzenia. Zwraca 0, jeżeli żaden dokument nie jest otwarty albo stos znaczników nie zawiera obecnie otwartego znacznika
Uwagi
Wywołaj tę funkcję po BeginTag lub BeginTagEx, a przed EndTag. Współrzędne używają domyślnego układu współrzędnych PDF, którego początek znajduje się w lewym dolnym rogu strony
Atrybut /BBox zdefiniowano w ISO 32000-1 §14.8.5.4 (właściciel atrybutów Layout). Jest szczególnie przydatny dla elementów struktury typu Figure, Form i Formula
Przykład
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;