harmony 鸿蒙@ohos.measure (文本计算)
@ohos.measure (文本计算)
本模块提供文本宽度、高度等相关计算。
说明
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import measure from '@ohos.measure'
measure.measureText
measureText(options: MeasureOptions): number
计算指定文本单行布局下的宽度。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
options | MeasureOptions | 是 | 被计算文本描述信息。 |
返回值:
类型 | 说明 |
---|---|
number | 文本宽度。 说明: 单位px。 |
示例:
import measure from '@ohos.measure'
@Entry
@Component
struct Index {
@State message: string = 'Hello World'
@State textWidth : number = measure.measureText({
textContent: "Hello word",
fontSize: '50px'
})
build() {
Row() {
Column() {
Text("The width of 'Hello World': " + this.textWidth)
}
.width('100%')
}
.height('100%')
}
}
measure.measureTextSize10+
measureTextSize(options: MeasureOptions): SizeOptions
计算指定文本单行布局下的宽度。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
options | MeasureOptions | 是 | 被计算文本描述信息。 |
返回值:
类型 | 说明 |
---|---|
SizeOption | 返回文本所占布局宽度和高度。 说明: 文本宽度以及高度返回值单位均为px。 |
示例:
import measure from '@ohos.measure'
@Entry
@Component
struct Index {
@State message: string = 'Hello World'
textSize : SizeOptions = measure.measureTextSize({
textContent: "Hello word",
fontSize: '50px'
})
build() {
Row() {
Column() {
Text("The width of 'Hello World': " + this.textSize.width)
Text("The height of 'Hello World': " + this.textSize.height)
}
.width('100%')
}
.height('100%')
}
}
MeasureOptions
被计算文本属性。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
textContent | string | 是 | 设置被计算文本内容。 |
constraintWidth10+ | number | string | Resource | 否 | 设置被计算文本布局宽度。 说明: 默认单位为vp |
fontSize | number | string | Resource | 否 | 设置被计算文本字体大小,fontSize为number类型时,使用fp单位。 默认值:16fp。 说明: 不支持设置百分比字符串。 |
fontStyle | number | FontStyle | 否 | 设置被计算文本字体样式。 默认值:FontStyle.Normal |
fontWeight | number | string | FontWeight | 否 | 设置被计算文本的字体粗细,number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。string类型仅支持number类型取值的字符串形式,例如”400”,以及”bold”、”bolder”、”lighter”、”regular”、”medium”,分别对应FontWeight中相应的枚举值。 默认值:FontWeight.Normal |
fontFamily | string | Resource | 否 | 设置被计算文本字体列表。默认字体’HarmonyOS Sans’,且当前只支持这种字体。 |
letterSpacing | number | string | 否 | 设置被计算文本字符间距。 |
textAlign10+ | number | TextAlign | 否 | 设置被计算文本水平方向的对齐方式。 默认值:TextAlign.Start |
overflow10+ | number | TextOverflow | 否 | 设置被计算文本超长时的截断方式。 |
maxLines10+ | number | 否 | 设置被计算文本最大行数。 |
lineHeight10+ | number | string | Resource | 否 | 设置被计算文本行高。 |
baselineOffset10+ | number | string | 否 | 设置被计算文本基线的偏移量。 默认值:0 |
textCase10+ | number | TextCase | 否 | 设置被计算文本大小写。 默认值:TextCase.Normal |
你可能感兴趣的鸿蒙文章
harmony 鸿蒙BundleStatusCallback
harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)
harmony 鸿蒙@ohos.distributedBundle (分布式包管理)
harmony 鸿蒙@ohos.bundle (Bundle模块)
harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)
0
赞
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦