SetMarkInfo

Propriedades do documento, acessibilidade

Descrição

Define o dicionário /MarkInfo do documento no Catálogo. Quando Marked é 1, o Catálogo recebe uma entrada /MarkInfo << /Marked true /Suspects false >>, declarando o documento como Tagged PDF. Quando Marked é 0, a entrada /MarkInfo é removida

Esta função é chamada automaticamente por SetPDFUAMode e por SetPDFAMode nos níveis de conformidade a (PDF/A-1a, PDF/A-2a, PDF/A-3a). Chame-a diretamente apenas quando necessitar do estado de PDF etiquetado sem a configuração completa de PDF/UA-1 ou PDF/A-A

Sintaxe

Delphi

Function TPDFlib.SetMarkInfo(Marked: Integer): Integer;

ActiveX

Function PDFlib::SetMarkInfo(Marked As Long) As Long

DLL

int DLSetMarkInfo(int InstanceID, int Marked);

Parâmetros

Valores devolvidos

Observações

A ISO 14289-1 (PDF/UA-1) §7.18.6 exige que /Suspects esteja presente e definido como false quando /Marked é true. A biblioteca escreve sempre /Suspects false juntamente com /Marked true, pelo que uma única chamada de SetMarkInfo(1) cumpre ambos os requisitos

Definir /Marked true é apenas uma declaração — por si só, não preenche a árvore de estrutura do documento. Depois de chamar SetMarkInfo(1), crie a árvore de estrutura com pares BeginTag/EndTag e marque o conteúdo decorativo com BeginArtifact/EndArtifact. Utilize GetPDFUADiagnostics para detetar lacunas comuns antes de guardar

O estado anterior de /MarkInfo num documento carregado pode ser consultado com IsTaggedPDF

Exemplo

// Convert a non-tagged loaded document into a tagged one, then add structure
PDF.LoadFromFile('source.pdf', '');
if PDF.IsTaggedPDF = 0 then
begin
  PDF.SetMarkInfo(1);

  // Re-open page 1 for editing
  PDF.SelectPage(1);
  PDF.BeginPageUpdate;
  PDF.BeginTag('H1', '', '');
  PDF.PrintText(50, 750, 'Document Title');
  PDF.EndTag;
  PDF.EndPageUpdate;
end;
PDF.SaveToFile('tagged.pdf');

Consulte também

IsTaggedPDF, SetPDFUAMode, SetPDFAMode, BeginTag, GetPDFUADiagnostics