THotPDF.SetLoadedFreeTextPlainText Method

Konverterar uttryckligen en stödd inläst FreeText-annotering till vänsterställd vanlig text och bygger upp dess normala appearance på nytt

Deklaration

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

Enhet: HPDFDoc · Finns sedan Version 2.753.0

Parametrar

• PageIndex: nollbaserat index för den inlästa sidan
• AnnotationIndex: nollbaserat annoteringsindex på den sidan
• AText: utskrivbara ASCII-tecken, med CR, LF eller CR/LF för explicita radbrytningar; tabbar, andra kontrolltecken och icke-ASCII-text avvisas
• FontSize: ändlig storlek i PDF-punkter, större än noll och högst 10 000, med 12 som standard

Appearance-konvertering

Metoden använder svart Helvetica-text och en svart rektangulär ram, behåller en stödd enhetsfärgad bakgrund samt heldragen eller streckad ramgeometri, och klipper texten till en tvåpunkters infällning inom annoteringsrektangeln

Raderna flyttas fram med 1,2 gånger typsnittsstorleken; automatisk radbrytning eller krympning för att få plats finns inte, så text utanför infällningen klipps bort

Konverteringen ersätter /AP, uppdaterar /Contents och /DA, sätter /Q till noll och tar bort /RC, /DS och /AS; den gamla rich texten, typsnittsvalet, textfärgen, justeringen och appearance-tillstånden ersätts medvetet

Ändringar av annotering, appearance och sida registreras för inkrementell sparning, och sidans render-cache ogiltigförklaras; sparning via fullständig omskrivning bevarar också den nya appearancen

Stödd indata och fel

Annoteringen måste finnas och ha subtypen FreeText, med en ändlig rektangel som är både bredare och högre än fyra punkter

Callouts, rektangelskillnader eller infällningar, rameffekter, en rotationspost, intent utanför FreeText, icke-opaka annoteringar, rundade ramar och ramstilar utöver heldragen eller streckad avvisas med EArgumentException

Bakgrundskomponenter i DeviceGray, DeviceRGB och DeviceCMYK måste ligga mellan noll och ett; rambredder och streckmönster måste vara giltiga, ändliga och icke-negativa, och ett icke-tomt streckmönster med enbart nollor avvisas

Indata som inte stöds valideras innan annoteringen eller dess appearance ersätts

Exempel

För ett inläst dokument där den första annoteringen på sida noll är en stödd FreeText-annotering

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

Relaterade API:er

SetLoadedAnnotationContents ändrar bara den lagrade innehållssträngen och bevarar en befintlig appearance

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Hem