4e773d59创建于 2025年4月21日历史提交

@ohos.graphics.text (文本模块)

本模块允许开发者创建复杂的文本段落，包括多样的文本样式、段落样式、换行规则等，并最终将这些信息转换为能在屏幕上高效渲染的布局数据，本模块采用屏幕物理像素单位px。

该模块提供以下创建复杂的文本段落的常用功能：

TextStyle：文本样式，控制文本的字体类型、大小、间距等属性。
FontCollection：字体管理器，控制各种不同的字体。
ParagraphStyle：段落样式，控制整个段落的显示样式。
Paragraph：段落，由ParagraphBuilder类调用build()接口构建而成。
ParagraphBuilder：段落生成器，控制生成不同的段落对象。
TextLine：以行为单位的段落文本的载体，由段落类调用getTextLines()接口获取。
Run：文本排版的渲染单元，由行文本类调用getGlyphRuns()接口获取。

说明：

本模块首批接口从API version 12开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { text } from '@kit.ArkGraphics2D';

text.getSystemFontFullNamesByType¹⁴⁺

getSystemFontFullNamesByType(fontType: SystemFontType): Promise<Array<string>>

根据字体类型返回该类型对应的所有字体的字体名称，使用Promise异步回调。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
fontType	SystemFontType	是	指定的字体类型。

返回值：

类型	说明
Promise<Array<string>>	Promise对象，返回相应字体类型的所有字体的字体名称。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified;2. Incorrect parameter types; 3. Parameter verification failed.

示例：

import { text } from "@kit.ArkGraphics2D"
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct Index {
  build() {
    Row() {
      Column() {
        Button("get font list")
          .fontSize(30)
          .fontWeight(FontWeight.Bold)
          .width(300)
          .height(80)
          .onClick(() => {
            let fontType:text.SystemFontType = text.SystemFontType.GENERIC
            let promise = text.getSystemFontFullNamesByType(fontType)
            promise.then((data) => {
              console.info(`then font list size: ${data.length}`)
              data.forEach((fontItem) => {
                console.info(fontItem)
              })
            }).catch((error: BusinessError) => {
              console.error(`Failed to get font fullNames by type, error: ${JSON.stringify(error)}`);
            });
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}

text.getFontDescriptorByFullName¹⁴⁺

getFontDescriptorByFullName(fullName: string, fontType: SystemFontType): Promise<FontDescriptor>

根据字体名称和字体类型获取对应的字体描述符，使用Promise异步回调。字体描述符是描述字体特征的一种数据结构，它包含了定义字体外观和属性的详细信息。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
fullName	string	是	指定的字体名称。是从字体文件的name表中解析出来的一个字段。可以使用getSystemFontFullNamesByType获取指定类型对应的所有字体的字体名称。
fontType	SystemFontType	是	指定的字体类型。

返回值：

类型	说明
Promise<FontDescriptor>	Promise对象，返回指定的字体描述符。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types.

示例：

import { text } from "@kit.ArkGraphics2D"
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct Index {
  build() {
    Row() {
      Column() {
        Button("get fontDesciptor")
          .fontSize(30)
          .fontWeight(FontWeight.Bold)
          .width(300)
          .height(80)
          .onClick(() => {
            let fontType:text.SystemFontType = text.SystemFontType.GENERIC
            let promise = text.getFontDescriptorByFullName("HarmonyOS Sans", fontType)
            promise.then((fontdecriptor) => {
              console.info(`desc: ${JSON.stringify(fontdecriptor)}`)
            }).catch((error: BusinessError) => {
              console.error(`Failed to get fontDescriptor by fullName, error: ${JSON.stringify(error)}`);
            });
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}

TextAlign

文本对齐方式枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
LEFT	0	文本靠左对齐。
RIGHT	1	文本靠右对齐。
CENTER	2	文本居中对齐。
JUSTIFY	3	文本两侧对齐，对最后一行无效。
START	4	基于文本的方向TextDirection，文本靠开头方向对齐。
END	5	基于文本的方向TextDirection，文本以结束方向对齐。

TextDirection

文本排版方向枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
RTL	0	文本从右到左排版。
LTR	1	文本从左到右排版。

BreakStrategy

断行策略枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
GREEDY	0	尽可能将当前行填满，不会自动添加连词符。
HIGH_QUALITY	1	布局优化，必要时会自动添加连词符。
BALANCED	2	保证一个段落的每一行的宽度相同，必要时会添加连词符。

WordBreak

断词策略枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
NORMAL	0	默认的换行规则。依据各自语言的规则，允许在字间发生换行。
BREAK_ALL	1	对于 Non-CJK（非中文，日文，韩文）文本允许在任意字符内发生换行。该值适合包含一些非亚洲文本的亚洲文本，比如使连续的英文字符断行。
BREAK_WORD	2	与`BREAK_ALL`基本相同，不同的地方在于它要求一个没有断行破发点的词必须保持为一个整体单位。

Decoration

文本装饰线。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
textDecoration	TextDecorationType	是	是	装饰线类型，默认为NONE。
color	common2D.Color	是	是	装饰线颜色，默认为透明。
decorationStyle	TextDecorationStyle	是	是	装饰线样式，默认为SOLID。
decorationThicknessScale	number	是	是	装饰线粗细相对于默认值的比例，浮点数，默认为1.0。

TextDecorationType

装饰线类型枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
NONE	0	装饰线不生效。
UNDERLINE	1	下划线。
OVERLINE	2	上划线。
LINE_THROUGH	4	删除线。

TextDecorationStyle

装饰线样式枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
SOLID	0	实线。
DOUBLE	1	双层线。
DOTTED	2	点状线。
DASHED	3	虚线。
WAVY	4	波浪线。

FontWeight

字重枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
W100	0	100字重。
W200	1	200字重。
W300	2	300字重。
W400	3	400字重。
W500	4	500字重。
W600	5	600字重。
W700	6	700字重。
W800	7	800字重。
W900	8	900字重。

FontWidth

字体宽度的枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
ULTRA_CONDENSED	1	超窄字宽。
EXTRA_CONDENSED	2	特窄字宽。
CONDENSED	3	窄的字宽。
SEMI_CONDENSED	4	半窄字宽。
NORMAL	5	常规字宽。
SEMI_EXPANDED	6	半宽字宽。
EXPANDED	7	宽的字宽。
EXTRA_EXPANDED	8	特宽字宽。
ULTRA_EXPANDED	9	超宽的字宽。

FontStyle

字体样式枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
NORMAL	0	常规样式。
ITALIC	1	斜体，如果当前字体没有可用的斜体版本，会选用倾斜体替代。
OBLIQUE	2	倾斜体，如果当前字体没有可用的倾斜体版本，会选用斜体替代。

TextHeightBehavior

文本高度修饰符模式枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
ALL	0x0	高度修饰符设置为段落中第一行和最后一行都上升。
DISABLE_FIRST_ASCENT	0x1	高度修饰符设置为禁止段落中第一行上升。
DISABLE_LAST_ASCENT	0x2	高度修饰符设置为禁止段落中最后一行上升。
DISABLE_ALL	0x1 \| 0x2	高度修饰符设置为段落中第一行和最后一行都不上升。

TextBaseline

文本基线类型枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
ALPHABETIC	0	通常用于拉丁字母的文本基线对齐。
IDEOGRAPHIC	1	通常用于CJK（中文，日文，韩文）的文本基线对齐。

EllipsisMode

省略号类型枚举。

EllipsisMode.START和EllipsisMode.MIDDLE仅在单行超长文本生效。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
START	0	开头省略号。
MIDDLE	1	中间省略号。
END	2	末尾省略号。

TextShadow

字体阴影。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
color	common2D.Color	是	是	字体阴影的颜色，默认为黑色Color(255, 0, 0, 0)。
point	common2D.Point	是	是	字体阴影基于当前文本的偏移位置，横、纵坐标要大于等于零。
blurRadius	number	是	是	模糊半径，浮点数，默认为0.0px。

RectStyle

矩形框样式。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
color	common2D.Color	是	否	矩形框的颜色。
leftTopRadius	number	是	否	矩形框的左上半径。
rightTopRadius	number	是	否	矩形框的右上半径。
rightBottomRadius	number	是	否	矩形框的右下半径。
leftBottomRadius	number	是	否	矩形框的左下半径。

FontFeature

文本字体特征。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
name	string	是	否	字体特征键值对中关键字所标识的字符串。
value	number	是	否	字体特征键值对的值。

FontVariation

可变字体属性。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
axis	string	是	否	可变字体属性键值对中关键字所标识的字符串。
value	number	是	否	可变字体属性键值对的值。

TextStyle

文本样式。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
decoration	Decoration	是	是	装饰线置，默认初始的Decoration。
color	common2D.Color	是	是	字体色，默认为白色。
fontWeight	FontWeight	是	是	字重，默认为W400。目前只有系统默认字体支持字重的调节，其他字体设置字重值小于semi-bold（即W600）时字体粗细无变化，当设置字重值大于等于semi-bold（即W600）时可能会触发伪加粗效果。
fontStyle	FontStyle	是	是	字体样式，默认为常规样式。
baseline	TextBaseline	是	是	文本基线型，默认为ALPHABETIC。
fontFamilies	Array<string>	是	是	字体族名称列表，默认为系统字体。
fontSize	number	是	是	字体大小，浮点数，默认为14.0，单位为px。
letterSpacing	number	是	是	字符间距，正数拉开字符距离，若是负数则拉近字符距离，浮点数，默认为0.0，单位为物理像素px。
wordSpacing	number	是	是	单词间距，浮点数，默认为0.0，单位为px。
heightScale	number	是	是	行高缩放倍数，浮点数，默认为1.0，heightOnly为true时生效。
heightOnly	boolean	是	是	true表示根据字体大小和heightScale设置文本框的高度，false表示根据行高和行距，默认为false。
halfLeading	boolean	是	是	true表示将行间距平分至行的顶部与底部，false则不平分，默认为false。
ellipsis	string	是	是	省略号样式，表示省略号生效后使用该字段值替换省略号部分。
ellipsisMode	EllipsisMode	是	是	省略号类型，默认为END，行尾省略号。
locale	string	是	是	语言类型，如字段为'en'代表英文，'zh-Hans'代表简体中文，'zh-Hant'代表繁体中文。具体请参照ISO 639-1规范，默认为空字符串。
baselineShift	number	是	是	文本下划线的偏移距离，浮点数，默认为0.0px。
fontFeatures	Array<FontFeature>	是	是	文本字体特征数组。
fontVariations	Array<FontVariation>	是	是	可变字体属性数组。
textShadows	Array<TextShadow>	是	是	文本字体阴影数组。
backgroundRect	RectStyle	是	是	文本矩形框样式。

StrutStyle

支柱样式，用于控制绘制文本的行间距、基线对齐方式以及其他与行高相关的属性，默认不开启。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
fontFamilies	Array<string>	是	是	字体类型，默认为系统字体。
fontStyle	FontStyle	是	是	字体样式，默认为常规样式。
fontWidth	FontWidth	是	是	字体宽度，默认为NORMAL。
fontWeight	FontWeight	是	是	字重，默认为W400。目前只有系统默认字体支持字重的调节，其他字体设置字重值小于semi-bold（即W600）时字体粗细无变化，当设置字重值大于等于semi-bold（即W600）时可能会触发伪加粗效果。
fontSize	number	是	是	字体大小，浮点数，默认为14.0，单位为物理像素px。
height	number	是	是	行高缩放倍数，浮点数，默认为1.0。
leading	number	是	是	以自定义行距应用于支柱的行距，浮点数，默认为-1.0。
forceHeight	boolean	是	是	是否所有行都将使用支柱的高度，true表示使用，false表示不使用，默认为false。
enabled	boolean	是	是	是否启用支柱样式，true表示使用，false表示不使用，默认为false。
heightOverride	boolean	是	是	是否覆盖高度，true表示覆盖，false表示不覆盖，默认为false。
halfLeading	boolean	是	是	true表示将行间距平分至行的顶部与底部，false则不平分，默认为false。

FontDescriptor¹⁴⁺

字体描述符信息。

系统能力：SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
path	string	否	是	字体绝对路径，可取任意值，默认值为空字符串。
postScriptName	string	否	是	字体唯一标识名称，可取任意值，默认值为空字符串。
fullName	string	否	是	字体名称，可取任意值，默认值为空字符串。
fontFamily	string	否	是	字体家族，可取任意值，默认值为空字符串。
fontSubfamily	string	否	是	子字体家族，可取任意值，默认值为空字符串。
weight	FontWeight	否	是	字体字重，默认值为FontWeight.W100的取值，即0。
width	number	否	是	字体宽度，取值范围是1-9整数，默认值为0。
italic	number	否	是	是否是斜体字体，0表示非斜体，1表示斜体字体，默认值为0。
monoSpace	boolean	否	是	是否是等宽字体，true表示等宽字体，false表示非等宽字体，默认值为false。
symbolic	boolean	否	是	是否支持符号，true表示支持，false表示不支持，默认值为false。

FontCollection

字体管理器。

getGlobalInstance

static getGlobalInstance(): FontCollection

获取应用全局FontCollection的实例。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
FontCollection	FontCollection对象。

示例：

import { text } from "@kit.ArkGraphics2D"

function textFunc() {
  let fontCollection = text.FontCollection.getGlobalInstance();
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

loadFontSync

loadFontSync(name: string, path: string | Resource): void

同步接口，将路径对应的文件，以name作为使用的别名，加载成自定义字体。其中参数name对应的值需要在TextStyle中的fontFamilies属性配置，才能显示自定义的字体效果。支持的字体文件格式包含：ttf、otf。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
name	string	是	加载成字体后，调用该字体所使用的命名。
path	string \| Resource	是	需要导入的字体文件的路径，应为 "file:// + 字体文件绝对路径" 或 "rawfile/目录or文件名"。

示例：

import { text } from "@kit.ArkGraphics2D"

let fontCollection: text.FontCollection = new text.FontCollection();

@Entry
@Component
struct RenderTest {
  LoadFontSyncTest() {
    fontCollection.loadFontSync('Clock_01', 'file:///system/fonts/HarmonyClock_01.ttf')
    let fontFamilies: Array<string> = ["Clock_01"]
    let myTextStyle: text.TextStyle = {
      fontFamilies: fontFamilies
    };
    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
    }
    let paragraphBuilder: text.ParagraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);

    let textData = "测试 loadFontSync 加载字体HarmonyClock_01.ttf";
    paragraphBuilder.addText(textData);
    let paragraph: text.Paragraph = paragraphBuilder.build();
    paragraph.layoutSync(600);
  }

  aboutToAppear() {
    this.LoadFontSyncTest();
  }

  build() {
  }
}

clearCaches

clearCaches(): void

清理字体排版缓存（字体排版缓存本身设有内存上限和清理机制，所占内存有限，如无内存要求，不建议清理）。

系统能力：SystemCapability.Graphics.Drawing

示例：

import { text } from "@kit.ArkGraphics2D"

@Entry
@Component
struct Index {
  build() {
    Column() {
      Button().onClick(() => {
        text.FontCollection.getGlobalInstance().clearCaches();
      })
    }
  }
}

ParagraphStyle

段落样式。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
textStyle	TextStyle	是	是	作用于整个段落的文本样式，默认为初始的文本样式。
textDirection	TextDirection	是	是	文本方向，默认为LTR。
align	TextAlign	是	是	文本对齐方式，默认为START。当与制表符对齐方式同时配置时（即同时配置tab属性时），制表符对齐方式不生效。
wordBreak	WordBreak	是	是	断词类型，默认为BREAK_WORD。
maxLines	number	是	是	最大行数限制，整数，默认为1e9。
breakStrategy	BreakStrategy	是	是	断行策略，默认为GREEDY。
strutStyle	StrutStyle	是	是	支柱样式，默认为初始的StrutStyle。
textHeightBehavior	TextHeightBehavior	是	是	文本高度修饰符模式，默认为ALL。

PlaceholderAlignment

占位符相对于周围文本的纵向的对齐方式。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
OFFSET_AT_BASELINE	0	基线与文本基线对齐。
ABOVE_BASELINE	1	将底部与文本基线对齐。
BELOW_BASELINE	2	将顶部与文本基线对齐。
TOP_OF_ROW_BOX	3	将顶部与文本顶部对齐。
BOTTOM_OF_ROW_BOX	4	将底部与文本底部对齐。
CENTER_OF_ROW_BOX	5	中线与文本的中线位置对齐。

说明：

示意图只展示了后三种，前三种与其类似，只不过比较位置变成了文本基线位置，即绿色线条部分。

PlaceholderSpan

描述占位符样式的载体。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
width	number	是	否	占位符的宽度，浮点数，单位为物理像素px。
height	number	是	否	占位符的高度，浮点数，单位为物理像素px。
align	PlaceholderAlignment	是	否	相对于周围文本的纵向的对齐方式。
baseline	TextBaseline	是	否	基线类型。
baselineOffset	number	是	否	基线偏移量，浮点数，单位为物理像素px。

Range

描述一个左闭右开的区间。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
start	number	是	否	区间左侧端点索引，整数。
end	number	是	否	区间右侧端点索引，整数。

Paragraph

保存着文本内容以及样式的载体，可以进行排版绘制等操作。

下列API示例中都需先使用ParagraphBuilder类的build()接口获取到Paragraph对象实例，再通过此实例调用对应方法。

layoutSync

layoutSync(width: number): void

进行排版，计算所有字形的位置。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
width	number	是	单行的最大宽度，浮点数，单位为物理像素px。

示例：

paragraph.layoutSync(100);

paint

paint(canvas: drawing.Canvas, x: number, y: number): void

在画布上以坐标点 (x, y) 为左上角位置绘制文本。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
canvas	drawing.Canvas	是	绘制的目标画布。
x	number	是	绘制的左上角位置的横坐标，浮点数。
y	number	是	绘制的左上角位置的纵坐标，浮点数。

示例：

const color: ArrayBuffer = new ArrayBuffer(160000);
let opts: image.InitializationOptions = { editable: true, pixelFormat: 3, size: { height: 200, width: 200 } }
let pixelMap: image.PixelMap = image.createPixelMapSync(color, opts);
let canvas = new drawing.Canvas(pixelMap);
paragraph.paint(canvas, 0, 0);

paintOnPath

paintOnPath(canvas: drawing.Canvas, path: drawing.Path, hOffset: number, vOffset: number): void

在画布上沿路径绘制文本。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
canvas	drawing.Canvas	是	绘制的目标画布。
path	drawing.Path	是	确认文字位置的路径。
hOffset	number	是	沿路径方向偏置，从路径起点向前为正，向后为负。
vOffset	number	是	沿路径垂直方向偏置，沿路径方向左侧为负，右侧为正。

示例：

const color: ArrayBuffer = new ArrayBuffer(160000);
let opts: image.InitializationOptions = { editable: true, pixelFormat: 3, size: { height: 200, width: 200 } }
let pixelMap: image.PixelMap = image.createPixelMapSync(color, opts);
let canvas = new drawing.Canvas(pixelMap);
let path = new drawing.Path();
path.arcTo(20, 20, 180, 180, 180, 90);
paragraph.paintOnPath(canvas, path, 0, 0);

getMaxWidth

getMaxWidth(): number

获取文本最大的行宽。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	最大的行宽，浮点数，单位为物理像素px。

示例：

let maxWidth = paragraph.getMaxWidth();

getHeight

getHeight(): number

获取文本总高度。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	总高度，浮点数，单位为物理像素px。

示例：

let height = paragraph.getHeight();

getLongestLine

getLongestLine(): number

获取文本最长一行的宽度。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	最长一行的宽度，浮点数，单位为物理像素px。

示例：

let longestLine = paragraph.getLongestLine();

getLongestLineWithIndent¹³⁺

getLongestLineWithIndent(): number

获取文本最长一行的宽度（该宽度包含当前行缩进的宽度），建议实际使用时将返回值向上取整。当文本内容为空时，返回0。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	最长一行的宽度（该宽度包含当前行缩进的宽度），浮点数，单位为物理像素px。

示例：

let longestLineWithIndent = paragraph.getLongestLineWithIndent();

getMinIntrinsicWidth

getMinIntrinsicWidth(): number

获取该段落所占水平空间的最小固有宽度。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	该段落所占水平空间的最小固有宽度，浮点数，单位为物理像素px。

示例：

let minIntrinsicWidth = paragraph.getMinIntrinsicWidth();

getMaxIntrinsicWidth

getMaxIntrinsicWidth(): number

获取该段落所占水平空间的最大固有宽度。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	该段落所占水平空间的最大固有宽度，浮点数，单位为物理像素px。

示例：

let maxIntrinsicWidth = paragraph.getMaxIntrinsicWidth();

getAlphabeticBaseline

getAlphabeticBaseline(): number

获取拉丁字母下的基线位置。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	拉丁字母下的基线位置，浮点数，单位为物理像素px。

示例：

let alphabeticBaseline = paragraph.getAlphabeticBaseline();

getIdeographicBaseline

getIdeographicBaseline(): number

获取表意字（如CJK（中文，日文，韩文））下的基线位置。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	获取表意字下的基线位置，浮点数，单位为物理像素px。

示例：

let ideographicBaseline = paragraph.getIdeographicBaseline();

getRectsForRange

getRectsForRange(range: Range, widthStyle: RectWidthStyle, heightStyle: RectHeightStyle): Array<TextBox>

获取给定的矩形区域宽度以及矩形区域高度的规格下，文本中该区间范围内的字符的所占的矩形区域。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
range	Range	是	需要获取的区域的文本区间。
widthStyle	RectWidthStyle	是	返回的矩形区域的宽度的规格。
heightStyle	RectHeightStyle	是	返回的矩形区域的高度的规格。

返回值：

类型	说明
Array<TextBox>	矩形区域数组。

示例：

let range: text.Range = { start: 0, end: 1};
let rects = paragraph.getRectsForRange(range, text.RectWidthStyle.TIGHT, text.RectHeightStyle.TIGHT);

getRectsForPlaceholders

getRectsForPlaceholders(): Array<TextBox>

获取文本中所有占位符所占的矩形区域。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
Array<TextBox>	矩形区域数组。

示例：

let placeholderRects = paragraph.getRectsForPlaceholders();

getGlyphPositionAtCoordinate

getGlyphPositionAtCoordinate(x: number, y: number): PositionWithAffinity

获取较为接近给定坐标的字形的位置信息。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
x	number	是	横坐标，浮点数。
y	number	是	纵坐标，浮点数。

返回值：

类型	说明
PositionWithAffinity	字形位置信息。

示例：

let positionWithAffinity = paragraph.getGlyphPositionAtCoordinate(0, 0);

getWordBoundary

getWordBoundary(offset: number): Range

返回给定的 offset 的字形所处的单词的索引区间。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
offset	number	是	字形的偏移量，整数。

返回值：

类型	说明
Range	单词的索引区间。

示例：

let wordRange = paragraph.getWordBoundary(0);

getLineCount

getLineCount(): number

返回文本行数量。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	文本行数量，整数。

示例：

let lineCount = paragraph.getLineCount();

getLineHeight

getLineHeight(line: number): number

返回指定行索引的行高。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
line	number	是	文本行索引，整数。

返回值：

类型	说明
number	行高。

示例：

let lineHeight = paragraph.getLineHeight(0);

getLineWidth

getLineWidth(line: number): number

返回指定行索引的行宽。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
line	number	是	文本行索引，整数。

返回值：

类型	说明
number	行宽。

示例：

let lineWidth = paragraph.getLineWidth(0);

didExceedMaxLines

didExceedMaxLines(): boolean

返回段落是否超过最大行限制。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
boolean	true表示段落超出了最大行限制，false则表示没有超出最大行限制。

示例：

let didExceed = paragraph.didExceedMaxLines();

getTextLines

getTextLines(): Array<TextLine>

返回所有的文本行载体。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
Array<TextLine>	文本行载体数组。

示例：

let lines = paragraph.getTextLines();

getActualTextRange

getActualTextRange(lineNumber: number, includeSpaces: boolean): Range

获取指定行号上的实际可见文本范围，这不包括由于文本溢出而显示的省略号。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
lineNumber	number	是	要获取文本范围的行号，行号从0开始。
includeSpaces	boolean	是	指示是否应包含空白字符。true表示包含空白字符，false表示不包含空白字符。

返回值：

类型	说明
Range	表明了对应行数的实际文本范围。

示例：

let rang = paragraph.getActualTextRange(0, true);

getLineMetrics

getLineMetrics(): Array<LineMetrics>

获取文本行的行度量数组。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
Array<LineMetrics>	文本行的行度量数组。

示例：

let arrLineMetrc =  paragraph.getLineMetrics();

getLineMetrics

getLineMetrics(lineNumber: number): LineMetrics | undefined

获取特定行号的行度量信息。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
lineNumber	number	是	要查询度量信息的行的编号, 行号从0开始。

返回值：

类型	说明
LineMetrics	如果指定的行号有效且度量信息存在，则返回一个包含该行度量数据的LineMetrics对象；如果行号无效或无法获取度量信息，则返回undefined。

示例：

let lineMetrics =  paragraph.getLineMetrics(0);

RunMetrics

描述文本行中连续文本块的布局信息和度量数据。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
textStyle	TextStyle	是	否	字体的样式信息。
fontMetrics	drawing.FontMetrics	是	否	字体度量信息。

LineMetrics

用于描述文本布局中单行文字的度量信息。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
startIndex	number	是	否	文本缓冲区中该行开始的索引位置。
endIndex	number	是	否	文本缓冲区中该行结束的索引位置。
ascent	number	是	否	文字上升高度，即从基线到字符顶部的距离。
descent	number	是	否	文字下降高度，即从基线到字符底部的距离。
height	number	是	否	当前行的高度，计算方式为 `Math.round(ascent + descent)`
width	number	是	否	行的宽度。
left	number	是	否	行的左边缘位置。右边缘可通过 `left+width` 计算得出。
baseline	number	是	否	该行基线相对于段落顶部的 Y 坐标位置。
lineNumber	number	是	否	行号，从0开始计数。
topHeight	number	是	否	从顶部到当前行的高度。
runMetrics	Map<number, RunMetrics>	是	否	文本索引范围与关联的字体度量信息之间的映射。

TextBox

文本矩形区域。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
rect	common2D.Rect	是	否	矩形区域信息。
direction	TextDirection	是	否	文本方向。

PositionWithAffinity

位置以及亲和度。

系统能力： SystemCapability.Graphics.Drawing

名称	类型	只读	可选	说明
position	number	是	否	字形相对于段落的索引，整数。
affinity	Affinity	是	否	位置亲和度。

RectWidthStyle

矩形区域宽度规格枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
TIGHT	0	不设置letterSpacing时，与字形紧贴，否则包含letterSpacing。
MAX	1	扩展宽度，以匹配所有行上最宽矩形的位置。

RectHeightStyle

矩形区域高度规格枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
TIGHT	0	与字形紧贴。
MAX	1	扩展高度，以匹配所有行上最高矩形的位置。
INCLUDE_LINE_SPACE_MIDDLE	2	每个矩形的顶部和底部将覆盖行上方和行下方的一半空间。
INCLUDE_LINE_SPACE_TOP	3	行间距将被添加到矩形的顶部。
INCLUDE_LINE_SPACE_BOTTOM	4	行间距将被添加到矩形的底部。
STRUT	5	高度按照文本的样式设置。

Affinity

位置亲和度枚举。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
UPSTREAM	0	该位置与文本位置的前一位有关联。
DOWNSTREAM	1	该位置与文本位置的后一位有关联。

ParagraphBuilder

段落生成器。

constructor

constructor(paragraphStyle: ParagraphStyle, fontCollection: FontCollection)

ParagraphBuilder对象的构造函数。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
paragraphStyle	ParagraphStyle	是	段落样式。
fontCollection	FontCollection	是	字体管理器。

示例：

import { text } from "@kit.ArkGraphics2D";

function textFunc() {
  let myTextStyle: text.TextStyle = {
    color: { alpha: 255, red: 255, green: 0, blue: 0 },
    fontSize: 33,
  };
  let myParagraphStyle: text.ParagraphStyle = {
    textStyle: myTextStyle,
    align: text.TextAlign.END,
  };
  let fontCollection = new text.FontCollection();
  let ParagraphGraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

pushStyle

pushStyle(textStyle: TextStyle): void

更新文本样式。

说明：

更新当前文本块的样式，直到对应的 popStyle 操作被执行，会还原到上一个文本样式。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
textStyle	TextStyle	是	包含了对文本的各种视觉属性的定义，如字体、字号、颜色、字重、字间距、行距、装饰（如下划线、删除线）、文本阴影等。

示例：

import { drawing } from '@kit.ArkGraphics2D'
import { text } from "@kit.ArkGraphics2D"
import { common2D } from "@kit.ArkGraphics2D"
import { image } from '@kit.ImageKit';

function textFunc() {
  let myTextStyle: text.TextStyle = {
    color: { alpha: 255, red: 255, green: 0, blue: 0 },
    fontSize: 33,
  };
  let myParagraphStyle: text.ParagraphStyle = {
    textStyle: myTextStyle,
    align: text.TextAlign.CENTER,
  };
  let fontCollection = new text.FontCollection();
  let ParagraphGraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);
  ParagraphGraphBuilder.pushStyle(myTextStyle);
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

popStyle

popStyle(): void

还原至上一个文本样式。

系统能力：SystemCapability.Graphics.Drawing

示例：

import { drawing } from '@kit.ArkGraphics2D'
import { text } from "@kit.ArkGraphics2D"
import { common2D } from "@kit.ArkGraphics2D"
import { image } from '@kit.ImageKit';

function textFunc() {
  let myTextStyle: text.TextStyle = {
    color: { alpha: 255, red: 255, green: 0, blue: 0 },
    fontSize: 33,
  };
  let myParagraphStyle: text.ParagraphStyle = {
    textStyle: myTextStyle,
    align: text.TextAlign.END,
  };
  let fontCollection = new text.FontCollection();
  let ParagraphGraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);
  ParagraphGraphBuilder.pushStyle(myTextStyle);
  ParagraphGraphBuilder.popStyle();
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

addText

addText(text: string): void

用于向正在构建的文本段落中插入具体的文本字符串。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
text	string	是	段落中插入的具体文本字符串。

示例：

import { drawing } from '@kit.ArkGraphics2D'
import { text } from "@kit.ArkGraphics2D"
import { common2D } from "@kit.ArkGraphics2D"
import { image } from '@kit.ImageKit';

function textFunc() {
  let myTextStyle: text.TextStyle = {
    color: { alpha: 255, red: 255, green: 0, blue: 0 },
    fontSize: 33,
  };
  let myParagraphStyle: text.ParagraphStyle = {
    textStyle: myTextStyle,
    align: text.TextAlign.END,
  };
  let fontCollection = new text.FontCollection();
  let ParagraphGraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);
  ParagraphGraphBuilder.addText("123666");
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

addPlaceholder

addPlaceholder(placeholderSpan: PlaceholderSpan): void

用于在构建文本段落时插入占位符。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
placeholderSpan	PlaceholderSpan	是	定义了占位符的尺寸、对齐方式、基线类型以及基线偏移量。

示例：

import { drawing } from '@kit.ArkGraphics2D'
import { text } from "@kit.ArkGraphics2D"
import { common2D } from "@kit.ArkGraphics2D"
import { image } from '@kit.ImageKit';

function textFunc() {
  let myParagraphStyle: text.ParagraphStyle = {
    align: text.TextAlign.END,
  };
  let myPlaceholderSpan: text.PlaceholderSpan = {
    width: 10000,
    height: 10000000,
    align: text.PlaceholderAlignment.ABOVE_BASELINE,
    baseline: text.TextBaseline.ALPHABETIC,
    baselineOffset: 100000
  };
  let fontCollection = new text.FontCollection();
  let ParagraphGraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);
  ParagraphGraphBuilder.addPlaceholder(myPlaceholderSpan);
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

build

build(): Paragraph

用于完成段落的构建过程，生成一个可用于后续排版渲染的段落对象。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
Paragraph	可用于后续渲染的 Paragraph 对象。

示例：

import { drawing, text, common2D } from '@kit.ArkGraphics2D'
import { image } from '@kit.ImageKit';

function textFunc() {
  let myTextStyle: text.TextStyle = {
    color : {alpha: 255, red: 255, green: 0, blue: 0},
    fontSize : 20,
  };
  let myParagraphStyle: text.ParagraphStyle = {
    textStyle : myTextStyle,
  };
  let fontCollection = new text.FontCollection();
  let ParagraphGraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);
  ParagraphGraphBuilder.addText("123456789");
  let paragraph = ParagraphGraphBuilder.build();
  paragraph.layoutSync(200);
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

addSymbol

addSymbol(symbolId: number): void

用于向正在构建的文本段落中插入具体的符号。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
symbolId	number	是	要设置的symbol码位，十六进制，当前支持的取值范围为：0xF0000-0xF0C97。可设置的symbol码位（即列表视图下的unicode值）请见主题图标库。

示例：

import { text } from "@kit.ArkGraphics2D";

function textFunc() {
  let myTextStyle: text.TextStyle = {
    color: { alpha: 255, red: 255, green: 0, blue: 0 },
    fontSize: 33,
  };
  let myParagraphStyle: text.ParagraphStyle = {
    textStyle: myTextStyle,
    align: text.TextAlign.END,
  };
  let fontCollection = new text.FontCollection();
  let ParagraphGraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);
  ParagraphGraphBuilder.addSymbol(0xF0000);
  let paragraph = ParagraphGraphBuilder.build();
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

TextLine

描述段落基础文本行结构的载体。

下列API示例中都需先使用Paragraph类的getTextLines()接口获取到TextLine对象实例，再通过此实例调用对应方法。

getGlyphCount

getGlyphCount(): number

获取该文本行中字形的数量。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	该文本行中字形数量，整数。

示例：

import { text } from "@kit.ArkGraphics2D"

function textFunc() {
  let GlyphCount = lines[0].getGlyphCount();
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

getTextRange

getTextRange(): Range

获取该文本行中的文本在整个段落文本中的索引区间。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
Range	该文本行中的文本在整个段落文本中的索引区间。

示例：

import { text } from "@kit.ArkGraphics2D"

function textFunc() {
  let textRange = lines[0].getTextRange();
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

getGlyphRuns

getGlyphRuns(): Array<Run>

获取该文本行中的文本渲染单位数组。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
Array<Run>	该文本行中的文本渲染单位数组。

示例：

import { text } from "@kit.ArkGraphics2D"

function textFunc() {
  let runs = lines[0].getGlyphRuns();
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

paint

paint(canvas: drawing.Canvas, x: number, y: number): void

在画布上以坐标点 (x, y) 为左上角位置绘制该文本行。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
canvas	drawing.Canvas	是	绘制的目标 canvas。
x	number	是	绘制的左上角位置的横坐标，浮点数。
y	number	是	绘制的左上角位置的纵坐标，浮点数。

示例：

import { drawing } from '@kit.ArkGraphics2D'
import { text } from "@kit.ArkGraphics2D"
import { common2D } from "@kit.ArkGraphics2D"
import { image } from '@kit.ImageKit';

function textFunc(pixelmap: PixelMap) {
  let canvas = new drawing.Canvas(pixelmap);
  lines[0].paint(canvas, 0, 0);
}

@Entry
@Component
struct Index {
  @State pixelmap?: PixelMap = undefined;
  fun: Function = textFunc;
  build() {
    Column() {
      Image(this.pixelmap).width(200).height(200);
      Button().onClick(() => {
        if (this.pixelmap == undefined) {
          const color: ArrayBuffer = new ArrayBuffer(160000);
          let opts: image.InitializationOptions = { editable: true, pixelFormat: 3, size: { height: 200, width: 200 } }
          this.pixelmap = image.createPixelMapSync(color, opts);
        }
        this.fun(this.pixelmap);
      })
    }
  }
}

Run

文本排版的渲染单元。

下列API示例中都需先使用TextLine类的getGlyphRuns()接口获取到Run对象实例，再通过此实例调用对应方法。

getGlyphCount

getGlyphCount(): number

获取该渲染单元中字形的数量。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
number	该渲染单元中字形数量，整数。

示例：

import { text } from "@kit.ArkGraphics2D"

function textFunc() {
  let glyphs = runs[0].getGlyphCount();
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

getGlyphs

getGlyphs(): Array<number>

获取该渲染单元中每个字符对应的字形序号。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
Array<number>	该渲染单元中每个字符对应的字形序号。

示例：

import { text } from "@kit.ArkGraphics2D"

function textFunc() {
  let glyph = runs[0].getGlyphs();
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

getPositions

getPositions(): Array<common2D.Point>

获取该渲染单元中每个字形相对于每行的字形位置。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
Array<common2D.Point>	该渲染单元中每个字形相对于每行的字形位置。

示例：

import { text } from "@kit.ArkGraphics2D";

function textFunc() {
  let positions = runs[0].getPositions(); // 获取渲染块全部字形位置
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

getOffsets

getOffsets(): Array<common2D.Point>

获取该渲染单元中每个字形相对于其索引的偏移量。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
Array<common2D.Point>	该渲染单元中每个字形相对于其索引的偏移量。

示例：

import { text } from "@kit.ArkGraphics2D";

function textFunc() {
  let offsets = runs[0].getOffsets();
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

getFont

getFont(): drawing.Font

获取该渲染单元的字体属性对象实例。

系统能力：SystemCapability.Graphics.Drawing

返回值：

类型	说明
drawing.Font	该渲染单元的字体属性对象实例。

示例：

import { drawing } from '@kit.ArkGraphics2D'
import { text } from "@kit.ArkGraphics2D";

function textFunc() {
  let font = runs[0].getFont();
}

@Entry
@Component
struct Index {
  fun: Function = textFunc;
  build() {
    Column() {
      Button().onClick(() => {
        this.fun();
      })
    }
  }
}

paint

paint(canvas: drawing.Canvas, x: number, y: number): void

在画布上以坐标点 (x, y) 为左上角位置绘制该渲染单元。

系统能力：SystemCapability.Graphics.Drawing

参数：

参数名	类型	必填	说明
canvas	drawing.Canvas	是	绘制的目标 canvas。
x	number	是	绘制的左上角位置的横坐标，浮点数。
y	number	是	绘制的左上角位置的纵坐标。浮点数。

示例：

import { drawing } from '@kit.ArkGraphics2D'
import { text } from "@kit.ArkGraphics2D"
import { common2D } from "@kit.ArkGraphics2D"
import { image } from '@kit.ImageKit';

function textFunc(pixelmap: PixelMap) {
  let canvas = new drawing.Canvas(pixelmap);
  runs[0].paint(canvas, 0, 0);
}

@Entry
@Component
struct Index {
  @State pixelmap?: PixelMap = undefined;
  fun: Function = textFunc;
  build() {
    Column() {
      Image(this.pixelmap).width(200).height(200);
      Button().onClick(() => {
        if (this.pixelmap == undefined) {
          const color: ArrayBuffer = new ArrayBuffer(160000);
          let opts: image.InitializationOptions = { editable: true, pixelFormat: 3, size: { height: 200, width: 200 } }
          this.pixelmap = image.createPixelMapSync(color, opts);
        }
        this.fun(this.pixelmap);
      })
    }
  }
}

SystemFontType¹⁴⁺

字体类型枚举，通过位或运算可实现组合类型。

系统能力： SystemCapability.Graphics.Drawing

名称	值	说明
ALL	1 << 0	所有字体类型，包括系统字体类型、风格字体类型和用户已安装字体类型。
GENERIC	1 << 1	系统字体类型。
STYLISH	1 << 2	风格字体类型。风格字体类型是专为2in1设备设计的字体类型。
INSTALLED	1 << 3	用户已安装的字体类型。

@ohos.graphics.text (文本模块)

导入模块

text.getSystemFontFullNamesByType14+

text.getFontDescriptorByFullName14+

TextAlign

TextDirection

BreakStrategy

WordBreak

Decoration

TextDecorationType

TextDecorationStyle

FontWeight

FontWidth

FontStyle

TextHeightBehavior

TextBaseline

EllipsisMode

TextShadow

RectStyle

FontFeature

FontVariation

TextStyle

StrutStyle

FontDescriptor14+

FontCollection

getGlobalInstance

loadFontSync

clearCaches

ParagraphStyle

PlaceholderAlignment

PlaceholderSpan

Range

Paragraph

layoutSync

paint

paintOnPath

getMaxWidth

getHeight

getLongestLine

getLongestLineWithIndent13+

getMinIntrinsicWidth

getMaxIntrinsicWidth

getAlphabeticBaseline

getIdeographicBaseline

getRectsForRange

getRectsForPlaceholders

getGlyphPositionAtCoordinate

getWordBoundary

getLineCount

getLineHeight

getLineWidth

didExceedMaxLines

getTextLines

getActualTextRange

getLineMetrics

getLineMetrics

RunMetrics

LineMetrics

TextBox

PositionWithAffinity

RectWidthStyle

RectHeightStyle

Affinity

ParagraphBuilder

constructor

pushStyle

popStyle

addText

addPlaceholder

build

addSymbol

TextLine

getGlyphCount

getTextRange

getGlyphRuns

paint

Run

getGlyphCount

getGlyphs

getPositions

text.getSystemFontFullNamesByType¹⁴⁺

text.getFontDescriptorByFullName¹⁴⁺

FontDescriptor¹⁴⁺

getLongestLineWithIndent¹³⁺

SystemFontType¹⁴⁺