SetMarkInfo
Dokumentegenskaber, tilgængelighed
Beskrivelse
Indstiller dokumentets /MarkInfo-ordbog i Catalog. Når Marked er 1, får Catalog en /MarkInfo << /Marked true /Suspects false >>-post, som erklærer dokumentet som en mærket PDF. Når Marked er 0, fjernes posten /MarkInfo
Denne funktion kaldes automatisk af SetPDFUAMode og af SetPDFAMode ved overensstemmelsesniveauerne a (PDF/A-1a, PDF/A-2a, PDF/A-3a). Kald den kun direkte, når du har brug for tagged-PDF-status uden den fulde PDF/UA-1- eller PDF/A-A-opsætning.
Syntaks
Delphi
Function TPDFlib.SetMarkInfo(Marked: Integer): Integer;
ActiveX
Function PDFlib::SetMarkInfo(Marked As Long) As Long
DLL
int DLSetMarkInfo(int InstanceID, int Marked);
Parametre
| Marked | 1 for at erklære dokumentet tagged (skriver /Marked true og /Suspects false); 0 for at fjerne posten /MarkInfo. |
|---|
Returværdier
| 1 | Posten /MarkInfo blev opdateret korrekt |
|---|
Bemærkninger
ISO 14289-1 (PDF/UA-1) §7.18.6 kræver, at /Suspects findes og er angivet til false, når /Marked er true. Biblioteket skriver altid /Suspects false sammen med /Marked true, så et enkelt kald til SetMarkInfo(1) opfylder begge krav.
Angivelse af /Marked true er kun en erklæring — den udfylder ikke i sig selv dokumentets strukturtræ. Efter kald til SetMarkInfo(1) skal strukturtræet opbygges med par af BeginTag/EndTag, og dekorativt indhold skal mærkes med BeginArtifact/EndArtifact. Brug GetPDFUADiagnostics til at vise almindelige mangler før lagring.
Den tidligere tilstand for /MarkInfo i et indlæst dokument kan forespørges med IsTaggedPDF.
Eksempel
// 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');Se også
IsTaggedPDF, SetPDFUAMode, SetPDFAMode, BeginTag, GetPDFUADiagnostics