THotPDF.SetLoadedFreeTextPlainText Method

A támogatott, betöltött FreeText annotációt explicit módon balra igazított egyszerű szöveggé alakítja, és újjáépíti a normális megjelenését

Deklaráció

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

Egység: HPDFDoc · a 2.753.0-s verziótól érhető el

Paraméterek

• PageIndex: a betöltött oldal nulla alapú indexe
• AnnotationIndex: az adott oldalon lévő annotáció nulla alapú indexe
• AText: nyomtatható ASCII karakterek, explicit sortörésekhez CR, LF vagy CR/LF; a tabulátorok, a többi vezérlőkarakter és a nem ASCII szöveg elutasításra kerül
• FontSize: véges méret PDF-pontban, nullánál nagyobb és legfeljebb 10,000, alapértelmezetten 12

Megjelenés-átalakítás

A metódus fekete Helvetica szöveget és fekete téglalap alakú keretet használ, megtartja a támogatott eszközszínű hátteret valamint a folytonos vagy szaggatott keretgeometriát, a szöveget pedig az annotáció téglalapján belül két pontos behúzásra vágja

A sorok a betűméret 1.2-szeresével lépnek; nincs automatikus sortörés vagy mérethez igazítás, így a behúzáson kívül eső szöveg levágásra kerül

Az átalakítás lecseréli a /AP bejegyzést, frissíti a /Contents és a /DA bejegyzést, a /Q értékét nullára állítja, valamint eltávolítja a /RC, a /DS és az /AS bejegyzést; a régi rich text, a betűtípus-választás, a szövegszín, az igazítás és a megjelenési állapotok szándékosan cserélődnek

Az annotáció, a megjelenés az oldal változásai növekményes mentésre kerülnek regisztrálásra, és az oldal renderelési gyorsítótára érvénytelenítve lesz; az újraírással történő mentés az új megjelenést is megőrzi

Támogatott bemenet és hibák

Az annotációnak léteznie kell, altípusa FreeText kell legyen, és rendelkeznie kell egy véges téglalappal, amelynek szélessége és magassága négy pontnál nagyobb

A calloutok, a téglalap-eltérések vagy behúzások, a kereteffektusok, egy elforgatási bejegyzés, a FreeText-től eltérő intent, a nem opak annotációk, a lekerekített keretek, valamint a folytonoson és szaggatotton kívüli keretstílusok EArgumentException kivétellel elutasításra kerülnek

A DeviceGray, DeviceRGB és DeviceCMYK háttérkomponenseknek nulla és egy között kell lenniük; a keretszélességeknek és a dash patterneknek érvényesnek, végesnek és nemnegatívnak kell lenniük, a nem üres, kizárólag nullákból álló dash pattern pedig elutasításra kerül

A nem támogatott bemenet az annotáció vagy a megjelenés cseréje előtt érvényesítésre kerül

Példa

Egy olyan betöltött dokumentumhoz, amelynek nulla sorszámú oldalán az első annotáció egy támogatott FreeText annotáció

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

Kapcsolódó API-k

A(z) SetLoadedAnnotationContents csak a tárolt contents karakterláncot módosítja, és megőrzi a meglévő megjelenést

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Kezdőlap