SetPDFUAModeA

Właściwości dokumentu, Dostępność

Opis

Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w SetPDFUAMode, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Włącza tryb zgodności PDF/UA-1 (ISO 14289-1:2014) dla wybranego dokumentu. To pojedyncze wywołanie wykonuje całą konfigurację na poziomie dokumentu wymaganą przez normę: wersja dokumentu zostaje podniesiona co najmniej do PDF 1.7, zapisywane są MarkInfo.Marked i MarkInfo.Suspects, w ViewerPreferences włączane jest DisplayDocTitle, gdy podano język ustawiane jest Catalog/Lang, a także zapisywany jest wpis przestrzeni nazw XMP pdfuaid:part=1. Gdy dokument jest szyfrowany po włączeniu SetPDFUAMode, CanCopyAccess (bit 10 klucza szyfrowania /P) jest automatycznie wymuszane niezależnie od maski TPDFExtraPermissions podanej przez wywołującego, zgodnie z ISO 14289-1 §7.16. Jeśli dokument był już zaszyfrowany przed wywołaniem SetPDFUAMode, istniejący słownik szyfrowania pozostaje bez zmian — wywołaj ponownie Encrypt po SetPDFUAMode, aby odświeżyć wartość /P. GetPDFUADiagnostics zgłasza tę sytuację kodem ENCRYPT-NO-ACCESS

Wywołaj tę metodę przed dodaniem jakiejkolwiek zawartości. Użyj BeginTag/EndTag oraz BeginArtifact/EndArtifact, aby oznaczyć zawartość dokumentu

Składnia

Delphi

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

DLL

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

Parametry

LanguageZnacznik języka BCP 47 określający domyślny język dokumentu, na przykład "en-US" lub "de". Przekaż pusty ciąg, aby pominąć wpis Catalog /Lang

Wartości zwracane

0Niepowodzenie (żaden dokument nie jest otwarty)
1Tryb PDF/UA został pomyślnie aktywowany

Uwagi

Podczas zapisu wszystkie otwarte strony automatycznie otrzymują wpis /Tabs /S (kolejność kart oparta na strukturze), gdy tryb PDF/UA jest aktywny, co spełnia wymagania ISO 14289-1 §7.18.3. Korekty wykonywane podczas zapisu uzupełniają również brakujące etykiety narzędzi widżetów (/TU) i wpisy adnotacji /Contents, dołączają /AFRelationship do plików osadzonych, usuwają wszystkie adnotacje TrapNet (zabronione przez ISO 14289-1 §7.18.2) oraz dołączają /O = List /ListNumbering = None do każdego elementu struktury L bez jawnego atrybutu ListNumbering (ISO 14289-1 §7.6)

Zobacz także: SetDocumentLanguage, SetMarkInfo, SetPDFAMode