THotPDF.SetLoadedFreeTextPlainText Method

Изрично преобразува поддържана заредена FreeText анотация в ляво подравнен обикновен текст и изгражда отново нейния нормален външен вид

Декларация

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

Unit: HPDFDoc · Налично от Version 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, изборът на шрифт, цветът на текста, подравняването и състоянията на външния вид се заменят умишлено

Промените в анотацията, външния вид и страницата се регистрират за инкрементално записване, а кешът за рендиране на страницата се инвалидира; записването чрез пренаписване също запазва новия външен вид

Поддържан вход и грешки

Анотацията трябва да съществува и да има подтип FreeText, с краен правоъгълник, по-широк и по-висок от четири точки

Callout елементи, разлики или отстъпи на правоъгълника, ефекти върху рамката, запис за ротация, intent, различен от FreeText, неплътни анотации, заоблени рамки и стилове на рамката, различни от плътна или прекъсната, се отхвърлят с EArgumentException

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

Неподдържаният вход се валидира, преди анотацията или нейният външен вид да бъдат заменени

Пример

За зареден документ, чиято първа анотация на страница нула е поддържана FreeText анотация

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

Свързани API

SetLoadedAnnotationContents само променя съхранения contents низ и запазва съществуващия външен вид

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Начало