SetPDFUAModeA

Dokumenteigenschaften, Barrierefreiheit

Beschreibung

Das abschließende A bezeichnet den ANSI-Einstiegspunkt (char) der DLL; die ActiveX/COM-Schnittstelle stellt nur die Unicode-Form bereit. Das Verhalten entspricht SetPDFUAMode, und Zeichenfolgenargumente werden anhand der aktuellen Codepage von SetAnsiMode interpretiert

Aktiviert den Konformitätsmodus PDF/UA-1 (ISO 14289-1:2014) für das ausgewählte Dokument. Dieser einzelne Aufruf führt die gesamte vom Standard geforderte Einrichtung auf Dokumentebene durch: Die Dokumentversion wird auf mindestens PDF 1.7 angehoben, MarkInfo.Marked und MarkInfo.Suspects werden geschrieben, DisplayDocTitle wird in ViewerPreferences aktiviert, Catalog/Lang wird bei Angabe einer Sprache festgelegt und der XMP-Namespace-Eintrag pdfuaid:part=1 wird geschrieben. Wird das Dokument verschlüsselt, nachdem SetPDFUAMode aktiviert wurde, wird CanCopyAccess (Bit 10 des Verschlüsselungsschlüssels /P) unabhängig von der vom Aufrufer angegebenen Maske TPDFExtraPermissions automatisch aktiviert, womit ISO 14289-1 §7.16 erfüllt wird. War das Dokument bereits vor dem Aufruf von SetPDFUAMode verschlüsselt, bleibt das vorhandene Verschlüsselungswörterbuch unverändert — rufen Sie Encrypt nach SetPDFUAMode erneut auf, um den Wert /P zu aktualisieren. GetPDFUADiagnostics meldet diese Situation als ENCRYPT-NO-ACCESS.

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können. BeginTag, EndTag, BeginArtifact, EndArtifact

Syntax

Delphi

Function DLSetPDFUAModeA(InstanceID: Integer; Language: PAnsiChar): Integer;

DLL

int DLSetPDFUAModeA(int InstanceID, const char * Language);

Parameter

Language	`"en-US"` ist ein Parameter von `"de"`. Verwenden Sie den in der Signatur gezeigten Typ und einen Wert, der zum aktuellen PDF-Dokument, zur ausgewählten Seite oder zur aktiven Ressource passt.

Rückgabewerte

0	Fehlgeschlagen (kein Dokument geöffnet)
1	PDF/UA-Modus erfolgreich aktiviert

Hinweise

Beim Speichern erhalten alle geöffneten Seiten automatisch einen Eintrag /Tabs /S (strukturierte Tabulatorreihenfolge), wenn der PDF/UA-Modus aktiv ist, womit ISO 14289-1 §7.18.3 erfüllt wird. Korrekturen beim Speichern ergänzen außerdem automatisch fehlende QuickInfos für Widgets (/TU) und /Contents-Einträge für Anmerkungen, hängen /AFRelationship an eingebettete Dateien an, entfernen sämtliche TrapNet-Anmerkungen (nach ISO 14289-1 §7.18.2 verboten) und hängen /O = List /ListNumbering = None an jedes L-Strukturelement an, dem ein ausdrückliches ListNumbering-Attribut fehlt (ISO 14289-1 §7.6).