AddTagAttributeA

PDF marcado, Acessibilidade

Descrição

O sufixo A indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de AddTagAttribute e os argumentos de string são interpretados usando a página de código atual definida por SetAnsiMode

Adiciona um atributo nomeado ao elemento de estrutura em construção no topo da pilha de tags. O atributo é gravado como um dicionário de atributos /A do PDF (ou array de dicionários) quando o documento é salvo. Chame 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 owner do atributo conforme definido na Tabela 348 da ISO 32000-1 (ex.: `Layout`, `Table`, `List`, `PrintField`). Ele se torna a chave `/O` no dicionário de atributos.
Name	O nome do atributo para o owner informado (ex.: `BBox` para Layout, `Scope` para Table). Não pode ser vazio.
Value	O valor do atributo como string. Valores contendo apenas números separados por espaço (ex.: `"0 0 200 100"`) são gravados como um array PDF de números reais. Qualquer outro valor é gravado como um name object do PDF (sem `/` inicial). Não pode ser vazio.

Valor de retorno

Retorna 1 em caso de sucesso. Retorna 0 se nenhum documento estiver aberto, se nenhuma tag estiver aberta no momento, ou se Owner ou Name estiver vazio.

Observações

Múltiplas chamadas a AddTagAttribute para a mesma tag aberta são acumuladas. Quando os atributos pertencem a um único owner, a biblioteca grava um único dicionário de atributos /A. Quando há vários owners, os atributos são agrupados por owner e gravados como um array de dicionários de atributos.

Para atributos comuns, os wrappers de conveniência SetStructElemScope e SetStructElemBBox podem ser usados em vez de chamar AddTagAttribute diretamente.

Os atributos são redefinidos quando uma nova tag é aberta; eles não são herdados pelos elementos filhos

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;

Veja também

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox