DrawShapedText

Text

Popis

Tato stránka popisuje DrawShapedText v PDFlibPas v tématu „Text". Názvy API, parametrů, tříd, souborů a literální hodnoty zůstávají zachovány tak, jak se objevují v knihovně Delphi a vstupních bodech DLL.

Před voláním funkce si projděte syntaxi, parametry a návratové hodnoty.

Syntaxe

Delphi

Function TPDFlib.DrawShapedText(XPos, YPos: Double; Const FontName: WideString; Size: Double; Const Text: WideString; Options: Integer): Integer;

Parametry

XPos/YPos určují polohu textu v jednotkách stránky. FontName pojmenovává nainstalované písmo (například Arial). Size je velikost textu v bodech. Text je řetězec, který má být tvarován a vykreslen. Bit 0 parametru Options vybírá základní směr odstavce zprava doleva; nastavte ho pro arabský nebo hebrejský text.

Vrácená hodnota

Vrátí 1 při úspěchu; 0 pokud není tvarovací stroj k dispozici, písmo není nainstalováno nebo Text je prázdný.

Poznámky

Text je tvarován systémovým tvarovacím strojem před vykreslením, takže arabská písmena zaujímají správné počáteční, prostřední, koncové nebo izolované formy; povinné ligatury jako lam-alef jsou aplikovány a přeběhy zprava doleva vycházejí ve správném vizuálním pořadí. Tvarované glyfy jsou zapisovány podle indexu glyfu prostřednictvím doprovodného písma Type0 (Identity-H), což umožňuje správné vykreslení forem bez vlastního kódu znaku. Pro každé písmo je vytvořeno jedno doprovodné písmo a opakovaně využíváno při dalších voláních ve stejném dokumentu. Při uložení dokumentu je vložený program písma oříznut na glyfy zobrazované dokumentem s reálnými šířkami na glyf a mapou ToUnicode, která přeloží každý tvarovaný glyf zpět na zdrojové znaky — text zkopírovaný nebo extrahovaný z výstupu tak vrátí původní řetězec včetně ligatur. Umístění je přesné: každý posun glyfu z tvarovacího stroje je zapsán do proudu obsahu, takže tisknuté rozvržení odpovídá tvarovanému měření z GetShapedTextWidth.