AddTagAttributeA

PDF etiquetado, acessibilidade

Descrição

O A final indica o ponto de entrada da DLL ANSI (char); a interface ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico a AddTagAttribute e os argumentos de cadeia são interpretados através da página de códigos atual de SetAnsiMode

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 DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;

DLL

int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * 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