THPDFHeadlessDocument.SetTextFieldValueWithAppearance

procedure SetTextFieldValueWithAppearance(FieldIndex: Integer;
  const Text: UnicodeString; const TrueTypeFont: SysUtils.TBytes;
  const Options: THPDFHeadlessTextAppearanceOptions);

Обновляет доступное для записи терминальное текстовое поле AcroForm и строит явный normal-внешний вид для каждого существующего виджета, используя один и тот же граф объектов документа на нативных Linux и Windows

Прямоугольники виджетов задают размеры внешнего вида; унаследованный Q поля задаёт выравнивание влево, по центру или вправо, когда присутствует, иначе применяется выравнивание из опций

Профиль поддерживает однострочный и многострочный простой текст, измеренный перенос слов с fallback по символам, разрывы строк CR/LF, фиксированный размер или автоподгонку, comb-ячейки с положительным унаследованным MaxLen и повороты виджета, кратные 90 градусам

Сложные письменности, bidi-run, лигатуры и комбинируемые последовательности обрабатываются HarfBuzz и FriBidi при включённом ShapeComplexText; прямой текст Unicode остаётся независимым от этих рантаймов, а отсутствующие глифы или некорректные суррогатные пары приводят к диагностике внешнего вида

Сложный многострочный перенос работает по логическим кластерам Unicode до переупорядочивания bidi и reshape'а; comb-ячейки сохраняют прямой профиль «один глиф на скаляр»

Для существующего rich-text поля метод заменяет содержимое одним простым стилем и синхронизирует V, RV и внешние виды всех виджетов; смешанные стили подавайте через SetRichTextFieldValueWithAppearance

Поля паролей генерируют по одной точке на скаляр Unicode и сохраняют реальное значение поля Unicode в V; карты глифов внешнего вида и текст доступности содержат маску, а значение подчиняется политике шифрования документа

Поля паролей не могут быть многострочными или comb-полями; некорректный Unicode, управляющие символы, отсутствующие глифы маски, отмена и исчерпание ресурсов сохраняют исходное поле

Поля выбора файла показывают литеральный путь Unicode как обычный текст поля; эта операция не открывает, не запускает и не прикрепляет выбранный файл

Шрифты требуют корректных именованных TrueType-контуров и реальных метрик с флагами встраивания installable или editable; встраивание полного шрифта соблюдает права no-subsetting и отклоняет restricted, preview-and-print, bitmap-only, отсутствующие и неизвестные права

Метод подготавливает все замены полей, словари внешних видов, новые объекты шрифтов и Form, а также бюджеты сериализации до изменения поля; сбои preflight сохраняют прежнее значение и ссылки внешних видов

Новые объекты принадлежат документу и сохраняются исходным ограниченным инкрементальным писателем, включая шифрование новых строк и потоков по исходной политике AES-256 R5 или R6

NeedAppearances сбрасывается, когда явные внешние виды покрывают изменённое поле, если только не остаются другое редактирование «только значение» или изначальное нерешённое требование внешнего вида

Когда исходный флаг истинен, другие поля без подписей консервативно сохраняют его истинным, пока их требования к внешним видам не удовлетворены; для регенерации этих полей используйте отдельные методы choice и button

Поля только для чтения, MaxLen, существующие подписи, права сертификации, права заполнения форм AES, защита источника, отмена и политики атомарного вывода продолжают действовать

Если токены отмены заданы и в документе, и в опциях внешнего вида, это должен быть один и тот же токен

Ограниченный шрифтово-вёрсточный контракт описывают THPDFHeadlessTextAppearanceOptions и HPDFBuildHeadlessTextAppearance