DrawShapedText

文本

描述

本页介绍 Delphi PDF 库中“文本”主题下的 DrawShapedText，API 名称、参数、类名、文件名和字面量均与 Delphi 库及 DLL 入口点中的写法完全一致

调用函数前请查看语法、参数和返回值

语法

Delphi

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

参数

XPos/YPos 以页面单位定位文本；FontName 指定已安装的字体字形，例如 Arial；Size 是以磅为单位的文本大小；Text 是要整形和绘制的字符串；Options 的位 0 选择从右到左的基方向

返回值

成功时返回 1，无法解析字形、0 所在的 Text 为空或字形塑形失败时返回

备注

库会读取解析后的字体程序，并优先使用可移植的原生 OpenType 引擎处理 GSUB 替换、GPOS 定位、文字脚本整形及视觉字形顺序；Windows 系统整形器仍作为兼容性回退方案，在原生模块无法加载时也可使用受限的 Pascal 布局路径

经过整形的字形通过可重用的 Type0 Identity-H 配套字体按字形索引写入，该字体按字形闭包进行子集化，具有真实的逐字形宽度和 ToUnicode 映射，可在提取时还原源簇

每个字形前进量和偏移量均写入内容流，因此打印布局与 GetShapedTextWidth 一致

精确字体句柄已可用，或操作不得依赖解析已安装字体名称时，请使用 DrawOpenTypeText