1 Star 0 Fork 344

seasky100 / awtk

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
mledit_t.md 12.71 KB
一键复制 编辑 原始数据 按行查看 历史
xianjimli 提交于 2020-04-27 08:36 . update docs

mledit_t

概述

image

多行编辑器控件。

mledit_t是widget_t的子类控件,widget_t的函数均适用于mledit_t控件。

在xml中使用"mledit"标签创建多行编辑器控件。如:

<mledit x="c" y="m" w="300" h="300" />

更多用法请参考:mledit.xml

在c代码中使用函数mledit_create创建多行编辑器控件。如:

widget_t* tc = mledit_create(win, 10, 10, 240, 240);

完整示例请参考:mledit demo

time_clock一般不需要设置style。

函数

函数名称 说明
mledit_cast 转换为mledit对象(供脚本语言使用)。
mledit_create 创建mledit对象
mledit_set_cursor 设置编辑器光标位置。
mledit_set_focus 设置为焦点。
mledit_set_keyboard 设置自定义软键盘名称。
mledit_set_max_lines 设置编辑器的最大行数。
mledit_set_readonly 设置编辑器是否为只读。
mledit_set_scroll_line 设置编辑器滚动速度。
mledit_set_tips 设置编辑器的输入提示。
mledit_set_tr_tips 获取翻译之后的文本,然后调用mledit_set_tips。
mledit_set_wrap_word 设置编辑器是否自动折行。

属性

属性名称 类型 说明
bottom_margin uint8_t 下边距。
keyboard char* 自定义软键盘名称。
left_margin uint8_t 左边距。
max_lines uint32_t 最大行数。
readonly bool_t 编辑器是否为只读。
right_margin uint8_t 右边距。
scroll_line uint32_t 鼠标一次滚动行数。
tips char* 输入提示。
top_margin uint8_t 上边距。
tr_tips char* 保存用于翻译的提示信息。
wrap_word bool_t 是否自动折行。

事件

事件名称 类型 说明
EVT_VALUE_CHANGING event_t 文本正在改变事件(编辑中)。
EVT_VALUE_CHANGED event_t 文本改变事件。

mledit_cast 函数


  • 函数功能:

转换为mledit对象(供脚本语言使用)。

  • 函数原型:
widget_t* mledit_cast (widget_t* widget);
  • 参数说明:
参数 类型 说明
返回值 widget_t* mledit对象。
widget widget_t* mledit对象。

mledit_create 函数


  • 函数功能:

创建mledit对象

  • 函数原型:
widget_t* mledit_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);
  • 参数说明:
参数 类型 说明
返回值 widget_t* 对象。
parent widget_t* 父控件
x xy_t x坐标
y xy_t y坐标
w wh_t 宽度
h wh_t 高度

mledit_set_cursor 函数


  • 函数功能:

设置编辑器光标位置。

  • 函数原型:
ret_t mledit_set_cursor (widget_t* widget, uint32_t cursor);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* widget对象。
cursor uint32_t 光标位置。

mledit_set_focus 函数


  • 函数功能:

设置为焦点。

  • 函数原型:
ret_t mledit_set_focus (widget_t* widget, bool_t focus);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* widget对象。
focus bool_t 是否为焦点。

mledit_set_keyboard 函数


  • 函数功能:

设置自定义软键盘名称。

  • 函数原型:
ret_t mledit_set_keyboard (widget_t* widget, char* keyboard);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* widget对象。
keyboard char* 键盘名称(相应UI资源必须存在)。

mledit_set_max_lines 函数


  • 函数功能:

设置编辑器的最大行数。

  • 函数原型:
ret_t mledit_set_max_lines (widget_t* widget, uint32_t max_lines);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* widget对象。
max_lines uint32_t 最大行数。

mledit_set_readonly 函数


  • 函数功能:

设置编辑器是否为只读。

  • 函数原型:
ret_t mledit_set_readonly (widget_t* widget, bool_t readonly);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* widget对象。
readonly bool_t 只读。

mledit_set_scroll_line 函数


  • 函数功能:

设置编辑器滚动速度。

  • 函数原型:
ret_t mledit_set_scroll_line (widget_t* widget, uint32_t scroll_line);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* widget对象。
scroll_line uint32_t 滚动行数。

mledit_set_tips 函数


  • 函数功能:

设置编辑器的输入提示。

  • 函数原型:
ret_t mledit_set_tips (widget_t* widget, char* tips);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* widget对象。
tips char* 输入提示。

mledit_set_tr_tips 函数


  • 函数功能:

获取翻译之后的文本,然后调用mledit_set_tips。

  • 函数原型:
ret_t mledit_set_tr_tips (widget_t* widget, const char* tr_tips);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* 控件对象。
tr_tips const char* 提示信息。

mledit_set_wrap_word 函数


  • 函数功能:

设置编辑器是否自动折行。

  • 函数原型:
ret_t mledit_set_wrap_word (widget_t* widget, bool_t wrap_word);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* widget对象。
wrap_word bool_t 是否自动折行。

bottom_margin 属性


下边距。

  • 类型:uint8_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

keyboard 属性


自定义软键盘名称。

  • 类型:char*
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

left_margin 属性


左边距。

  • 类型:uint8_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

max_lines 属性


最大行数。

  • 类型:uint32_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

readonly 属性


编辑器是否为只读。

  • 类型:bool_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

right_margin 属性


右边距。

  • 类型:uint8_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

scroll_line 属性


鼠标一次滚动行数。

  • 类型:uint32_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

tips 属性


输入提示。

  • 类型:char*
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

top_margin 属性


上边距。

  • 类型:uint8_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

tr_tips 属性


保存用于翻译的提示信息。

  • 类型:char*
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

wrap_word 属性


是否自动折行。

  • 类型:bool_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
C
1
https://gitee.com/seasky100/awtk.git
git@gitee.com:seasky100/awtk.git
seasky100
awtk
awtk
master

搜索帮助

344bd9b3 5694891 D2dac590 5694891