THotPDF.SetLoadedFreeTextPlainText Method

Явно переводит поддерживаемую загруженную FreeText-аннотацию в выровненный по левому краю plain text и заново строит её normal appearance

Объявление

procedure SetLoadedFreeTextPlainText(PageIndex, AnnotationIndex: Integer;
  const AText: AnsiString; FontSize: Single = 12);

Модуль: HPDFDoc · Доступно с версии 2.753.0

Параметры

• PageIndex: индекс загруженной страницы (отсчёт от нуля)
• AnnotationIndex: индекс аннотации на этой странице (отсчёт от нуля)
• AText: печатаемые ASCII-символы; явные разрывы строк задаются CR, LF или CR/LF; табуляция, прочие управляющие символы и не-ASCII текст отклоняются
• FontSize: конечный размер в пунктах PDF, больше нуля и не более 10 000, по умолчанию 12

Преобразование внешнего вида

Метод рисует текст чёрным Helvetica с чёрной прямоугольной рамкой, сохраняет поддерживаемый device-color фон и геометрию сплошной или пунктирной рамки, а текст обрезает по отступу в два пункта внутри прямоугольника аннотации

Строки сдвигаются с шагом 1.2 от размера шрифта; автоматического переноса или уменьшения под размер нет, поэтому текст за пределами отступа обрезается

Преобразование заменяет /AP, обновляет /Contents и /DA, обнуляет /Q и удаляет /RC, /DS и /AS; старый rich text, выбор шрифта, цвет текста, выравнивание и состояния appearance намеренно заменяются

Изменения аннотации, appearance и страницы регистрируются для инкрементального сохранения, а render cache страницы сбрасывается; при сохранении перезаписью новый внешний вид тоже сохраняется

Поддерживаемый ввод и ошибки

Аннотация должна существовать, иметь подтип FreeText и конечный прямоугольник шириной и высотой больше четырёх пунктов

Callout, отличия или отступы прямоугольника, эффекты рамки, запись поворота, intent, отличный от FreeText, аннотации с прозрачностью, скруглённые рамки и стили рамок, отличные от сплошной или пунктирной, отклоняются исключением EArgumentException

Компоненты фона DeviceGray, DeviceRGB и DeviceCMYK должны лежать в диапазоне от нуля до единицы; ширины рамок и шаблоны штрихов должны быть корректными, конечными и неотрицательными, а непустой шаблон штриха из одних нулей отклоняется

Неподдерживаемый ввод проверяется до замены аннотации или её внешнего вида

Пример

Для загруженного документа, у которого первая аннотация на странице с индексом ноль является поддерживаемой FreeText-аннотацией

PDF.SetLoadedFreeTextPlainText(0, 0,
  'Updated review note'#13#10'Second line', 12);

Связанные API

SetLoadedAnnotationContents меняет только сохранённую contents-строку и оставляет существующий appearance как есть

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Главная