THotPDF.SetLoadedFreeTextText Method

Замінює нормальний вигляд завантаженої анотації FreeText, використовуючи вбудовані шрифти Unicode, необов'язковий багатий текст і атомарну транзакцію графа

Оголошення

procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
  const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
  const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');

Параметри

Ініціалізуйте запис через THPDFLoadedTextAppearanceOptions.Default перед зміною окремих полів

ПолеПоведінка
FontName, FontStyle, FontSizeОсновний шрифт, стиль і кегль у пунктах; типові значення — Arial, звичайний і 12 пунктів
TextColor, Alignment, PaddingКолір простого тексту, вирівнювання ліворуч/по центру/праворуч і відступ у пунктах; типові значення — чорний, ліворуч і 2 пункти
Opacity, RotationНепрозорість у [0,1] і обертання, кратне 90 градусам
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ltopReject відхиляє переповнення, ltopClip обрізає його, а ltopShrinkToFit повторює спробу меншими шрифтами
MinFontSizeНижня межа зменшення, типово 4 пункти
MaxTextUnitsБюджет входу та простого тексту, типово 1,048,576 одиниць UTF-16; багатий вхід обмежений чотирма такими бюджетами

Поведінка

AText подає простий текст Unicode; непорожній UTF-8 RichContent натомість використовує HTML-імпортер і необов'язковий CSS DefaultStyle, після чого /Contents виводиться зі згенерованого тексту

Згенерований вигляд копіює вбудовані шрифти та відображення ToUnicode у завантажений документ, тож збереження, зведення і витягання тексту зберігають його текст Unicode

Метод успадковує налаштовані ланцюги резервних шрифтів, ShapingFeatures, перемикачі auto-shaping для Arabic, Syriac, N'Ko, Adlam і Hanifi Rohingya, а також вибори GSUB-сценарію та мови; кожна повторна спроба shrink-to-fit використовує ті самі налаштування, не змінюючи конфігурацію викликача

Він зберігає підтримувані фон, суцільну/пунктирну рамку, відступи прямокутника та геометрію виноски з двох/трьох точок і синхронізує /AP, /Contents, /RC, /DS, /CA, /Q і метадані обертання

Недійсна геометрія, нерозв'язані гліфи простого тексту, хмарні рамки, ліміти ресурсів і відхилене переповнення створюють виняток і відкочують усе оновлення; наявні зовнішні транзакції графа залишаються активними

Багатий текст дотримується підтримуваної підмножини HTML/CSS; зовнішні ресурси вимкнені, а фіксовані розміри шрифтів CSS можуть завадити shrink-to-fit зменшити окремі прогони

Кожен записувач виглядів приймає щонайбільше 256 різних shaping-виборів шрифтів і 64 МіБ сукупних сирих даних шрифтів; перевищення будь-якого ліміту відхиляє оновлення та зберігає початкову анотацію

Пов'язані API