AddTagAttribute

PDF etiquetado, acessibilidade

Descrição

Adiciona um atributo designado ao elemento de estrutura que está a ser criado na pilha de etiquetas. O atributo é escrito como um dicionário de atributos PDF /A (ou matriz de dicionários) quando o documento é guardado. Chame esta função depois de BeginTag ou BeginTagEx e antes de EndTag

Sintaxe

Delphi

Function TPDFlib.AddTagAttribute(Const Owner, Name, Value: WideString): Integer;

ActiveX

Function PDFlib::AddTagAttribute(Owner As String, Name As String, Value As String) As Long

DLL

int DLAddTagAttribute(int InstanceID, const wchar_t * Owner, const wchar_t * Name, const wchar_t * Value);

Parâmetros

Owner	O nome do proprietário do atributo, conforme definido na Tabela 348 de ISO 32000-1 (por exemplo, `Layout`, `Table`, `List`, `PrintField`). Torna-se a chave `/O` do dicionário de atributos
Name	O nome do atributo do proprietário indicado (por exemplo, `BBox` para Layout, `Scope` para Table). Não pode estar vazio
Value	O valor do atributo como cadeia. Os valores que contêm apenas números separados por espaços (por exemplo, `"0 0 200 100"`) são escritos como uma matriz PDF de números reais. Qualquer outro valor é escrito como um objeto de nome PDF (sem um `/` inicial). Não pode estar vazio

Valor devolvido

Devolve 1 em caso de êxito. Devolve 0 se nenhum documento estiver aberto, nenhuma etiqueta estiver aberta ou Owner ou Name estiver vazio

Observações

As várias chamadas de AddTagAttribute para a mesma etiqueta aberta são acumuladas. Quando os atributos pertencem a um único proprietário, a biblioteca escreve um único dicionário de atributos /A. Quando são utilizados vários proprietários, os atributos são agrupados por proprietário e escritos como uma matriz de dicionários de atributos

Para atributos comuns, os invólucros de conveniência SetStructElemScope e SetStructElemBBox podem ser utilizados em vez de invocar AddTagAttribute diretamente

Os atributos são repostos quando é aberta uma nova etiqueta; não são herdados pelos elementos subordinados

Exemplo

// Mark a table header cell with column scope
PDFlib.BeginTag('TH', '', '', '');
PDFlib.AddTagAttribute('Table', 'Scope', 'Column');
// ... draw cell content
PDFlib.EndTag;

// Mark a figure with a bounding box
PDFlib.BeginTag('Figure', 'Company logo', '', '');
PDFlib.AddTagAttribute('Layout', 'BBox', '72 600 200 700');
PDFlib.EndTag;

Consulte também

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox