THotPDF.SetLoadedFreeTextText Method

Zastępuje normalne appearance załadowanej adnotacji FreeText, używając osadzonych fontów Unicode, opcjonalnego rich text i atomowej transakcji grafu

Deklaracja

procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
  const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
  const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');

Opcje

Zainicjuj rekord przez THPDFLoadedTextAppearanceOptions.Default, zanim zmienisz poszczególne pola

PoleZachowanie
FontName, FontStyle, FontSizePodstawowy font, styl i rozmiar w punktach; domyślnie Arial, zwykły i 12 punktów
TextColor, Alignment, PaddingKolor zwykłego tekstu, wyrównanie lewo/środek/prawo i padding w punktach; domyślnie czarny, lewo i 2 punkty
Opacity, RotationKrycie w [0,1] i rotacja w wielokrotnościach 90 stopni
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ltopReject odrzuca przepełnienie, ltopClip je przycina, a ltopShrinkToFit ponawia próbę z mniejszymi fontami
MinFontSizeDolna granica pomniejszania, domyślnie 4 punkty
MaxTextUnitsBudżet wejścia i zwykłego tekstu, domyślnie 1,048,576 jednostek UTF-16; wejście rich text jest ograniczone do czterokrotności tego budżetu

Zachowanie

AText dostarcza zwykły tekst Unicode; niepuste UTF-8 RichContent używa zamiast tego importera HTML i opcjonalnego CSS DefaultStyle, a następnie wyprowadza /Contents z wygenerowanego tekstu

Wygenerowane appearance kopiuje osadzone fonty i mapowania ToUnicode do załadowanego dokumentu, więc zapis, spłaszczanie i ekstrakcja tekstu zachowują jego tekst Unicode

Metoda dziedziczy skonfigurowane łańcuchy fallback fontów, ShapingFeatures, przełączniki auto-shaping dla arabskiego, syriackiego, n'ko, adlam i hanifi rohingya oraz wybory skryptu i języka GSUB; każda próba shrink-to-fit używa tych samych ustawień bez zmiany konfiguracji wywołującego

Zachowuje obsługiwane tło, obramowanie solid/dashed, insets prostokąta i dwu-/trzypunktową geometrię callout oraz synchronizuje /AP, /Contents, /RC, /DS, /CA, /Q i metadane rotacji

Nieprawidłowa geometria, nierozstrzygnięte glify zwykłego tekstu, chmurowe obramowania, limity zasobów i odrzucone przepełnienie podnoszą wyjątek i cofają całą aktualizację; istniejące zewnętrzne transakcje grafu pozostają aktywne

Rich text podlega obsługiwanemu podzbiorowi HTML/CSS; zasoby zewnętrzne są wyłączone, a stałe rozmiary fontów w CSS mogą uniemożliwić shrink-to-fit zmniejszenie pojedynczych przebiegów

Każdy writer appearance akceptuje co najwyżej 256 różnych wyborów fontów shaping i 64 MiB skumulowanych surowych danych fontów; przekroczenie któregokolwiek limitu odrzuca aktualizację i zachowuje pierwotną adnotację

Powiązane API