DrawShapedText

Text

Descriere

Această pagină descrie DrawShapedText în PDFlibPas în cadrul subiectului „Text". Numele API, parametrii, numele claselor, numele de fișiere și literalele sunt păstrate exact așa cum apar în biblioteca Delphi și punctele de intrare DLL.

Examinați sintaxa, parametrii și valorile returnate înainte de a apela funcția.

Sintaxă

Delphi

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

Parametri

XPos/YPos pozitionează textul în unitățile paginii. FontName denumește o față de font instalată (de exemplu Arial). Size este dimensiunea textului în puncte. Text este șirul de formatat și desenat. Bitul 0 al parametrului Options selectează o direcție de paragraf de bază de la dreapta la stânga; setați-l pentru textul arab sau ebraic.

Valoare returnată

Returnează 1 în caz de succes; 0 când motorul de formatare este indisponibil, fața de font nu este instalată sau Text este gol.

Note

Textul este formatat cu motorul de formatare al sistemului înainte de a fi desenat, astfel încât literele arabe capătă formele corecte (inițiale, mediale, finale sau izolate), ligaturile obligatorii precum lam-alef sunt aplicate, iar secvențele de la dreapta la stânga apar în ordinea vizuală corectă. Glifele formatate sunt scrise prin index de glifă printr-un font Type0 companion (Identity-H), ceea ce permite formelor care nu au un cod de caracter propriu să fie redate corect. Un font companion este creat pentru fiecare față și reutilizat de apelurile ulterioare din același document. Când documentul este salvat, programul font integrat este subsetat la exact glifele pe care documentul le afișează, cu lățimi reale per glifă și o hartă ToUnicode care traduce fiecare glifă formatată înapoi la caracterele sursă — astfel textul copiat sau extras din ieșire returnează șirul original, inclusiv ligaturi. Poziționarea este exactă: fiecare avans de glifă din motorul de formatare este scris în fluxul de conținut, astfel încât aspectul tipărit corespunde măsurătorii formatate din GetShapedTextWidth.