THotPDF.SetLoadedFreeTextPlainText Method

Jawnie konwertuje obsługiwaną wczytaną adnotację FreeText na wyrównany do lewej tekst zwykły i odbudowuje jej wygląd normalny

Deklaracja

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

Jednostka: HPDFDoc · Dostępne od wersji 2.753.0

Parametry

• PageIndex: indeks wczytanej strony liczony od zera
• AnnotationIndex: indeks adnotacji na tej stronie liczony od zera
• AText: drukowalne znaki ASCII, z CR, LF lub CR/LF jako jawnymi złamaniami wiersza; tabulatory, inne znaki kontrolne i tekst spoza ASCII są odrzucane
• FontSize: skończony rozmiar w punktach PDF, większy od zera i wynoszący co najwyżej 10 000, domyślnie 12

Konwersja wyglądu

Metoda używa czarnego tekstu Helvetica i czarnej prostokątnej ramki, zachowuje obsługiwane tło w kolorze urządzenia oraz geometrię ramki ciągłej lub przerywanej, a tekst przycina do dwupunktowego wcięcia wewnątrz prostokąta adnotacji

Wiersze przesuwają się o 1,2 rozmiaru czcionki; nie ma automatycznego zawijania ani zmniejszania do dopasowania, więc tekst poza wcięciem jest przycinany

Konwersja zastępuje /AP, aktualizuje /Contents i /DA, ustawia /Q na zero i usuwa /RC, /DS oraz /AS; stary rich text, wybór czcionki, kolor tekstu, wyrównanie i stany wyglądu są celowo zastępowane

Zmiany adnotacji, wyglądu i strony są rejestrowane do zapisu przyrostowego, a cache renderowania strony jest unieważniany; zapis przez ponowny zapis również zachowuje nowy wygląd

Obsługiwane dane wejściowe i błędy

Adnotacja musi istnieć i mieć podtyp FreeText, ze skończonym prostokątem szerszym i wyższym niż cztery punkty

Callouty, różnice lub wcięcia prostokąta, efekty ramki, wpis rotacji, intencja inna niż FreeText, adnotacje niepełnokryjące, zaokrąglone ramki i style ramek inne niż ciągła lub przerywana są odrzucane wyjątkiem EArgumentException

Składniki tła DeviceGray, DeviceRGB i DeviceCMYK muszą mieścić się w zakresie od zera do jednego; szerokości ramek i wzory kreskowania muszą być poprawne, skończone i nieujemne, a niepusty wzór kreskowania z samych zer jest odrzucany

Nieobsługiwane dane wejściowe są walidowane przed zastąpieniem adnotacji lub jej wyglądu

Przykład

Dla wczytanego dokumentu, którego pierwsza adnotacja na stronie zero jest obsługiwaną adnotacją FreeText

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

Powiązane API

SetLoadedAnnotationContents zmienia tylko zapisany łańcuch contents i zachowuje istniejący wygląd

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Start