EndArtifact
PDF etiquetado, acessibilidade
Descrição
Fecha a região de artefacto aberta mais recentemente, escrevendo um operador EMC (fim de conteúdo marcado) no fluxo de conteúdo da página atual. Cada chamada de BeginArtifact tem de corresponder exatamente a uma chamada de EndArtifact
Sintaxe
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);Valores devolvidos
| 0 | Falha — não existe um documento aberto ou não está aberta qualquer região de artefacto |
|---|---|
| 1 | A região de artefacto foi fechada com êxito |
Observações
As regiões de artefactos e os elementos de estrutura partilham a mesma pilha de conteúdo marcado para a página atual. EndArtifact só fecha a região aberta mais acima se esta tiver sido aberta com BeginArtifact; nunca o utilize para fechar um elemento de estrutura aberto com BeginTag ou as respetivas variantes — chame EndTag nesses casos
As regiões de artefactos podem ser aninhadas em elementos de estrutura quando o artefacto representa um gráfico decorativo visualmente associado ao conteúdo estrutural. Contudo, não podem conter elementos de estrutura: os leitores PDF avisarão ou recusarão respeitar a estrutura dentro de um artefacto
Os subtipos habituais de artefactos que justificam uma região separada são cabeçalhos, rodapés, números de página, limites decorativos, marcas de água e imagens de fundo. Marcá-los como artefactos exclui-os da ordem de leitura apresentada ao utilizador pelas tecnologias de apoio
Exemplo
// Running footer drawn once per page, as an artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 30, 'Annual Report 2026 — page ' + IntToStr(pageNo));
PDF.EndArtifact;
// Page header with the company logo, also an artifact
PDF.BeginArtifact('Header');
PDF.DrawImage(50, 800, 60, 30, logoHandle);
PDF.EndArtifact;