SetStructElemBBox
PDF etiquetado, acessibilidade
Descrição
Define o atributo /BBox (proprietário do atributo Layout) no elemento de estrutura atualmente aberto na pilha de etiquetas. A caixa delimitadora associa uma região retangular, em coordenadas do espaço do utilizador, ao elemento de estrutura, sendo utilizada por ferramentas de acessibilidade e motores de redisposição. Equivale a chamar AddTagAttribute com Owner=Layout, Name=BBox e uma cadeia de coordenadas separadas por espaços
Sintaxe
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);Parâmetros
| Left | Margem esquerda da caixa delimitadora em unidades predefinidas do espaço do utilizador (pontos, 1/72 polegada) |
|---|---|
| Bottom | Margem inferior da caixa delimitadora |
| Right | Margem direita da caixa delimitadora |
| Top | Extremidade superior da caixa delimitadora |
Valor devolvido
Devolve 1 em caso de êxito. Devolve 0 se não houver nenhum documento aberto ou nenhuma etiqueta atualmente aberta na pilha de etiquetas
Observações
Chame esta função depois de BeginTag ou BeginTagEx e antes de EndTag. As coordenadas seguem o sistema de coordenadas predefinido do PDF, cuja origem se encontra no canto inferior esquerdo da página
O atributo /BBox é definido na norma ISO 32000-1 §14.8.5.4 (proprietário do atributo Layout). É especialmente útil para tipos de elementos de estrutura Figure, Form e Formula
Exemplo
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;