DrawShapedText

Text

Opis

Táto stránka popisuje DrawShapedText v PDFlibPas v téme „Text". Názvy API, parametre, názvy tried, názvy súborov a literály sú zachované presne tak, ako sa zobrazujú v knižnici Delphi a vstupných bodoch DLL.

Pred volaním funkcie si preštudujte syntax, parametre a návratové hodnoty.

Syntax

Delphi

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

Parametre

XPos/YPos určujú polohu textu v jednotkách stránky. FontName určuje nainštalované písmo (napríklad Arial). Size je veľkosť textu v bodoch. Text je reťazec na vytvarovanie a vykreslenie. Bit 0 parametra Options nastavuje smer odstavcovej základne sprava doľava; nastavte ho pre arabský alebo hebrejský text.

Návratová hodnota

Vráti 1 pri úspechu; 0, keď je tvarovací engine nedostupný, písmo nie je nainštalované alebo je Text prázdny.

Poznámky

Text je pred vykreslením tvarovaný pomocou systémového tvarovacieho enginu, takže arabské písmená nadobúdajú správne tvary na začiatku slova, v strede, na konci alebo izolovane; povinné ligatúry ako lam-alef sú aplikované a behy sprava doľava sú zobrazené v správnom vizuálnom poradí. Tvarované glyfmi sú zapísané podľa indexu glyfu cez sprievodný font Type0 (Identity-H), čo umožňuje správne vykreslenie tvarov, ktoré nemajú vlastný kód znaku. Na každé písmo sa vytvorí jeden sprievodný font, ktorý neskoršie volania v tom istom dokumente znova použijú. Pri ukladaní dokumentu je vložený font sústredený len na glyfy zobrazené v dokumente, so skutočnými šírkami glyfu a mapou ToUnicode, ktorá prekladá každý tvarovaný glyf späť na jeho zdrojové znaky — text skopírovaný alebo extrahovaný z výstupu teda vráti pôvodný reťazec vrátane ligatúr. Polohovanie je presné: každý posun glyfu z tvarovacieho enginu je zapísaný do prúdu obsahu, takže vytlačené rozmiestnenie zodpovedá tvarovanému meraniu z GetShapedTextWidth.