SetStructElemScope

PDF etiquetado, acessibilidade

Descrição

Define o atributo /Scope (proprietário do atributo Table) no elemento de estrutura atualmente aberto na pilha de etiquetas. O âmbito identifica se uma célula TH (cabeçalho de tabela) se aplica a uma coluna, uma linha ou ambas — exigido pelo PDF/UA-1 para tabelas com células de cabeçalho. Equivale a chamar AddTagAttribute com Owner=Table, Name=Scope e o nome do âmbito como valor

Sintaxe

Delphi

Function TPDFlib.SetStructElemScope(Const Scope: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemScope(Scope As String) As Long

DLL

int DLSetStructElemScope(int InstanceID, const wchar_t * Scope);

Parâmetros

Scope	O âmbito da célula de cabeçalho. Tem de ser um dos seguintes valores (sensíveis a maiúsculas e minúsculas): Column — o cabeçalho aplica-se a todas as células da coluna Row — o cabeçalho aplica-se a todas as células da linha Both — o cabeçalho aplica-se à coluna e à linha

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 após BeginTag (com o tipo de etiqueta TH) e antes de EndTag. O atributo /Scope é definido em ISO 32000-1 §14.8.5.7.2 (proprietário de atributos Table)

O PDF/UA-1 (ISO 14289-1 §7.10) exige que as células de cabeçalho da tabela estejam claramente associadas às respetivas células de dados. O fornecimento do atributo /Scope é o mecanismo recomendado quando a disposição da tabela o permite

Exemplo

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

Consulte também

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode