输入文字
# 一、概述
输入文字是一个带有标签和光标的输入框。可以在其中输入文本或字符。输入首先需要创建一个虚拟键盘，同时将虚拟键盘关联到文本框。
# 二、控件设置
控件设置包含如下部分，控件标题，尺寸，外观，属性，事件，选中尺寸，会列出尺寸对应设置细节，以下会对各部分功能分别介绍。
## 控件标题
控件名称为了方便理解和记忆可以修改，如：LvglImgBtn1修改为：LvglImgBtn1_mytest。
## 尺寸
包括排列方式，X,Y轴坐标，拖动控件会改变对应X,Y轴坐标，也可以手动设置。屏幕左上角为像素坐标原点(x=0,y=0)。
【排列】：支持。。。。等排列方式，（注：暂时未实现）
【宽度】：输入文本宽度，可手动设置，也可以直接拖动修改
【高度】：输入文本高度，可手动设置，也可以直接拖动修改
【X轴】：描述控件在屏幕上的像素X坐标位置，可手动设置，也可以直接拖动修改
【Y轴】：描述控件在屏幕上的像素Y坐标位置，可手动设置，也可以直接拖动修改
## 外观
外观部件分为背景区域，光标区域2部分。
### 背景区域
背景区域可以设置背景样式和文字样式，见上图外观显示部分。
#### 背景样式
背景样式，可以设置背景颜色，不透明度（0-255）设置为0是表示完全透明，渐变色，渐变开始，渐变结束，渐变方向，混合模式，如下图所示：
#### 文字样式
文字样式，可以设置文本颜色、字体、字号大小等。（默认支持宋体16号，如果要支持黑体，得保证你的硬件设备上有矢量字库芯片，否则设置黑体后会显示不了相应的文字内容），如下图所示：
### 光标区域
光标区域无内容可设置。
## 属性
属性包含输入文字，提示文字（无输入内容时的提示语），隐藏光标，光标闪烁时长，单行模式，密码模式，文本排列，可输入字符，最大输入长度，超长文本，滚动条模式，滚动传播，如下图所示：
## 事件
包含文字插入，改变，回车，单击事件，每种事件包含函数和屏幕２个选项。（绑定虚拟键盘后事件无效），如下图所示：
# 三、使用详解
## 打开UI设计器
首先先创建一个UI工程，这个不做说明，参考前面的快速入门新建工程章节，然后点击UI设计器按钮进入UI设计界面。
## 添加输入文字
首先点击添加组件按钮，会出现一个下拉菜单，然后选择输入文字图标，点击确认。
## 控件名称修改
控件名称可以修改用户需要的，方便用户理解，同时会自动生成对应的代码。
## 尺寸设置
可以通过设置X,Y轴坐标设置控件位置，也可以手动拖拽标签放到合适的位置，坐标会自动变化，屏幕左上角为像素坐标原点(x=0,y=0)。宽度和高度都可以设置。
## 外观设置
外观分为背景区域，光标区域2部分，点击编辑进入对应设置界面，点击清除删除对应设置。
### 背景区域
背景区域包含背景样式，文字样式2部分。
#### 背景样式
背景样式，可以设置背景颜色，不透明度，渐变色，渐变开始值，渐变结束值，渐变方向，混合模式。点击编辑进入对应设置界面，点击清除删除对应设置。
#### 文字样式
文本样式设置，包含文本颜色，不透明度，字体，字号，粗细度，字间距，行间距，修饰符，选中文字颜色，点击编辑进入对应设置界面，点击清除删除对应设置。
### 光标区域
无内容需要设置。
## 属性设置
属性设置包含输入文字，提示文字（无输入内容时的提示语），隐藏光标，光标闪烁时长，单行模式，密码模式，文本排列，可输入字符，最大输入长度，超长文本，滚动条模式，滚动传播。
## 运行效果
通过上面外观和属性设置后，实际运行效果如下所示：
## 事件设置
包含文字插入，改变，回车，单击事件（和虚拟键盘关联后事件设置无效），这里我们添加一个虚拟键盘和文本框关联做数字输入和打印的演示，去做关联做屏幕切换演示。
### 函数控制
这里我们添加一个虚拟键盘，并关联到我们前面创建的LvglTextarea1文本框上，在UiDesign.lua脚本里会自动注册lvgl_UiDesigner_DefOutCb消息处理函数，这里我们在添加一个文字插入的消息处理，来打印输入文字的内容。
点击运行后，以为默认虚拟键盘是隐藏的，我们可以通过点击输入框来显示出虚拟键盘，然后通过虚拟键盘输入数字，为了演示效果，这里我们关闭密码模式，文本框属性设置的可输入字符为0123456789，最大输入长度为11，虚拟键盘属性的按键类型设置为数字模式，所以这里我们只能输入最大长度为11的数字。
添加一个文字插入消息处理来打印输入文字的内容，运行效果如下：
### 屏幕切换
首先添加一个新屏幕用来演示用，点击事件选择屏幕，选择新建的mytest屏幕，在UiDesign.lua会自动生成，注册点击事件的消息回调函数，去除掉和虚拟键盘的关联，运行模拟器后点击文本框后，会切换到刚才创建的mytest屏幕。
# 四、操作视频