SetPDFUAModeA

Свойства документа, доступность

Описание

Завершающая A обозначает точку входа ANSI (char) в DLL; интерфейс ActiveX/COM открывает только Unicode-форму. Поведение идентично SetPDFUAMode, а строковые аргументы интерпретируются в кодовой странице, заданной текущим режимом SetAnsiMode

Активирует режим соответствия PDF/UA-1 (ISO 14289-1:2014) для выбранного документа. Этот единственный вызов выполняет всю требуемую стандартом настройку уровня документа: версия документа поднимается минимум до PDF 1.7, записываются MarkInfo.Marked и MarkInfo.Suspects, в ViewerPreferences включается DisplayDocTitle, при указании языка задаётся Catalog/Lang и записывается запись пространства имён XMP pdfuaid:part=1. Когда документ шифруется уже при активном SetPDFUAMode, CanCopyAccess (бит 10 ключа шифрования /P) принудительно включается независимо от переданной вызывающим маски TPDFExtraPermissions, выполняя ISO 14289-1 §7.16. Если документ был зашифрован до вызова SetPDFUAMode, существующий словарь шифрования остаётся без изменений — после SetPDFUAMode вызовите Encrypt ещё раз, чтобы обновить значение /P. GetPDFUADiagnostics сообщает об этой ситуации кодом ENCRYPT-NO-ACCESS.

Вызывайте до добавления любого содержимого. Тегируйте содержимое документа парами BeginTag/EndTag и BeginArtifact/EndArtifact

Синтаксис

Delphi

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

DLL

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

Параметры

Language	Тег языка BCP 47 для языка документа по умолчанию, например `"en-US"`, `"de"`. Пустая строка пропускает запись Catalog /Lang

Возвращаемые значения

0	Failed (no document is open)
1	PDF/UA mode activated successfully

Примечания

При сохранении всем открытым страницам автоматически добавляется запись /Tabs /S (порядок табуляции по структуре), когда активен режим PDF/UA, что удовлетворяет ISO 14289-1 §7.18.3. Сохранение также автоматически заполняет отсутствующие подсказки виджетов (/TU) и записи аннотаций /Contents, присоединяет /AFRelationship к внедренным файлам, удаляет аннотации TrapNet (запрещены ISO 14289-1 §7.18.2) и добавляет /O = List /ListNumbering = None структурному элементу L без явного атрибута ListNumbering (ISO 14289-1 §7.6)