MultiTextBox

简介

MultiTextBox 控件,它是一个文本显示控件,它支持排版换行显示。

MultiTextBox 的基类是 widget , widget 属性及接口详细请查看 widget 控件介绍。基础属性中某些属性在 MultiTextBox 控件中无效(可以设置这类接口属性,但并无效果,显示状态上并无任何变化,因此可以忽略此类属性),不可用属性有:

  • gesture:手势监听属性

控件属性:包含基础控件所有属性。

属性名 类型 描述
automatic Bool 根据文本排版后行数自动改变控件高度
clear Bool 清空控件文本
rowHeight Number 配置行高
compose Bool 手动更新排版
lineAlign String 文本行对齐
value String 设置文本内容
add String 追加文本内容

setData 功能

automatic 属性功能

主要用于使能 MultiTextBox 控件根据排版后文本行数调整控件高度的功能。

属性 类型 说明
automatic Bool true 使能;false 关闭使能
this.setData({ MultiTextBox1: { automatic: true } });   /* 使能根据行数调整控件高度 */

this.setData({ MultiTextBox1: { automatic: false } });  /* 关闭使能根据行数调整控件高度 */

clear 属性功能

主要用于清空 MultiTextBox 控件文本。

属性 类型 说明
clear Bool true 则清空;false 无效
this.setData({ MultiTextBox1: { clear: true } });   /* 清空文本 */

rowHeight 属性功能

主要用于配置 MultiTextBox 行高属性。

属性 类型 说明
rowHeight Number 文本行高
this.setData({ MultiTextBox1: { rowHeight: 30 } });

compose 属性功能

主要用于配置 MultiTextBox 行高属性。

属性 类型 说明
compose Bool true 更新排版;false 无效
this.setData({ MultiTextBox1: { compose: true } });

lineAlign 属性功能

主要用于配置 MultiTextBox 行对齐方式,有顶对齐,剧中对齐,底对齐。

属性 类型 说明
lineAlign String 文本行对齐
this.setData({ MultiTextBox1: { lineAlign: "RTGUI_ALIGN_TOP" } });
this.setData({ MultiTextBox1: { lineAlign: "RTGUI_ALIGN_CENTER" } });
this.setData({ MultiTextBox1: { lineAlign: "RTGUI_ALIGN_BOTTOM" } });

value 属性功能

主要用于配置 MultiTextBox 文本内容。

属性 类型 说明
value String 设置文本内容
this.setData({ MultiTextBox1: { value: "MultiTextBox1" } });
this.setData({ MultiTextBox1: "MultiTextBox1" });

add 属性功能

主要用于往 MultiTextBox 追加文本内容。

属性 类型 说明
add String 追加文本内容
this.setData({ MultiTextBox1: { add: "MultiTextBox1" } });