THotPDF.SetLoadedFreeTextPlainText Method

Konverterer eksplicit en understøttet indlæst FreeText-annotation til venstrestillet plain text og genopbygger dens normale appearance

Deklaration

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

Enhed: HPDFDoc · Tilgængelig siden Version 2.753.0

Parametre

• PageIndex: nulbaseret indeks for den indlæste side
• AnnotationIndex: nulbaseret annotationsindeks på den side
• AText: udskrivbare ASCII-tegn, med CR, LF eller CR/LF til eksplicitte linjeskift; tabs, andre kontroltegn og ikke-ASCII-tekst afvises
• FontSize: endelig størrelse i PDF-punkter, større end nul og højst 10,000, som standard 12

Appearance-konvertering

Metoden bruger sort Helvetica-tekst og en sort rektangulær ramme, bevarer en understøttet device-color-baggrund og solid eller stiplet rammegeometri og klipper teksten til en to-punkts inset inden i annotationsrektanglet

Linjer rykker 1,2 gange skriftstørrelsen fremad; der er ingen automatisk ombrydning eller shrink-to-fit, så tekst uden for insettet klippes

Konverteringen erstatter /AP, opdaterer /Contents og /DA, sætter /Q til nul og fjerner /RC, /DS og /AS; den gamle rich text, fontvalg, tekstfarve, justering og appearance-tilstande erstattes bevidst

Annotations-, appearance- og sideændringer registreres til inkrementel gemning, og sidens render-cache gøres ugyldig; omskrivningsgemning bevarer også det nye udseende

Understøttet input og fejl

Annotationen skal findes og have subtypen FreeText, med et endeligt rektangel, der er bredere og højere end fire punkter

Callouts, rektangel-differences eller -insets, border effects, en rotationspost, ikke-FreeText-intent, ikke-opake annotationer, afrundede rammer og rammestile andet end solid eller stiplet afvises med EArgumentException

DeviceGray-, DeviceRGB- og DeviceCMYK-baggrundskomponenter skal være mellem nul og ét; rammebredder og dash-mønstre skal være gyldige, endelige og ikke-negative, og et ikke-tomt all-zero dash-mønster afvises

Ikke-understøttet input valideres, før annotationen eller dens appearance erstattes

Eksempel

For et indlæst dokument, hvis første annotation på side nul er en understøttet FreeText-annotation

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

Relaterede API'er

SetLoadedAnnotationContents ændrer kun den gemte contents-streng og bevarer en eksisterende appearance

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Hjem