Flythings学习（二）控件相关

---

1 前言

本系列笔记根据flythings官方文档进行学习，连接如下，相关下载在文档中的环境安装部分
https://developer.flythings.cn/zh-hans/

2 通用属性

2.1 控件ID值

ID值作为控件的唯一标识，每一个FTU文件里的控件ID值是不允许重名的，不同的ftu文件里的控件ID值允许重名；设置id后，编译完全会在activity目录下对应的头文件中生成相应的宏定义

所有控件都能使用

/*** 该接口定义于控件基类ZKBase中* 头文件位置： include/control/ZKBase.h** 注意： 以下接口如未特殊说明，都表示定义在ZKBase类中* 所有控件直接或间接的继承了ZKBase类，所以，所有的控件都可以调用ZKBase类中public接口*/
int getID() const;/* 操作样例： 点击按钮控件，打印该控件ID值 */
static bool onButtonClick_Button1(ZKButton *pButton) {int id = pButton->getID();LOGD("onButtonClick_Button1 id %d\n", id);return false;
}

2.2 控件位置

// 设置位置
void setPosition(const LayoutPosition &position);
// 获取位置
const LayoutPosition& getPosition();

样例

/* 操作样例 */
// 点击按钮控件，设置该按钮位置
static bool onButtonClick_Button1(ZKButton *pButton) {// 左：0，上：0，宽：100，高：200LayoutPosition pos(0, 0, 100, 200);pButton->setPosition(pos);return false;
}// 点击按钮控件，获取该按钮位置
static bool onButtonClick_Button2(ZKButton *pButton) {// pos的mLeft、mTop、mWidth、mHeight变量分别对应的就是坐标值LayoutPosition pos = pButton->getPosition();return false;
}

2.3 背景色

/*** Z6、Z11、A33平台接口定义* color为-1时，背景设置为透明；其他颜色值为0x RGB，颜色值不支持alpha*/
void setBackgroundColor(int color);/*** H500S、Z20、Z21及以后平台接口定义* color 颜色值为0x ARGB，支持alpha*/
void setBackgroundColor(uint32_t color);/* 操作样例： 点击按钮控件，设置背景颜色为红色 */
static bool onButtonClick_Button1(ZKButton *pButton) {pButton->setBackgroundColor(0xFFFF0000);return false;
}

2.4 背景图

/*** pPicPath参数可以有以下两种方式：* 1. 绝对路径，如："/mnt/extsd/pic/bg.png"* 2. 相对资源目录路径，只需把图片放到项目工程resources目录下，编译打包后，就可以使用了，如resources目录下有bg.png图片，只需设置"bg.png"即可*/
void setBackgroundPic(const char *pPicPath);/* 操作样例 */
mButton1Ptr->setBackgroundPic("/mnt/extsd/pic/bg.png"); // 设置绝对路径
mButton1Ptr->setBackgroundPic("bg.png");    // 设置resources目录下bg.png图片

2.5 显示与隐藏

void setVisible(bool isVisible);
bool isVisible() const;
/* 操作样例 */
mButton1Ptr->setVisible(true);  // 显示按钮控件
mButton1Ptr->setVisible(false); // 隐藏按钮控件/*** 窗口控件还可以使用下面的接口，功能一样* 头文件位置： include/window/ZKWindow.h*/
void showWnd();  // 显示窗口
void hideWnd();  // 隐藏窗口
bool isWndShow() const;  // 窗口是否显示/* 操作样例 */
mWindow1Ptr->showWnd();
mWindow1Ptr->hideWnd();

2.6 控件状态

// 设置选中状态
void setSelected(bool isSelected);
bool isSelected() const;/* 操作样例 */
mButton1Ptr->setSelected(true);
mButton1Ptr->setSelected(false);/*** 无效状态作用说明：控件设置为无效状态情况下，触摸控件没有作用，即不响应按下抬起事件*/
// 设置无效状态
void setInvalid(bool isInvalid);
bool isInvalid() const;/* 操作样例 */
mButton1Ptr->setInvalid(true);
mButton1Ptr->setInvalid(false);

2.7 蜂鸣器控制

// 所有控件都支持beep接口，以下为操作样例
mButton1Ptr->beep();// 全局控制蜂鸣器
#include "manager/ConfigManager.h"
// 接口参数说明： true 开启、false 关闭
CONFIGMANAGER->setBeepEnable(true);

3 文本类TextView

通过代码动态更新文本内容
比如通过点击一个按钮，更新文字内容

static bool onButtonClick_Button1(ZKButton *pButton) {mTextView1Ptr->setText("Hello World");return false;
}/* 操作样例 */
mTextView1Ptr->setText(123); // TextView1控件将显示"123"字符串
mTextView1Ptr->setText('c'); // TextView1控件将显示'c'字符

修改文字颜色大小等，可以通过控件更改，也可以通过代码更改

   //将控件TextView1 设置为无效状态；如果属性表中`无效时颜色`属性不为空，则将其设置为指定的颜色，否则无变化。mTextView1Ptr->setInvalid(true);//将控件TextView1 设置为选中状态；如果属性表中`选中时颜色`属性不为空，则将其设置为指定的颜色，否则无变化。mTextView1Ptr->setSelected(true);//将控件TextView1 设置为按下状态；如果属性表中`按下时颜色`属性不为空，则将其设置为指定的颜色，否则无变化。mTextView1Ptr->setPressed(true);//将控件TextView1 设置为红色。mTextView1Ptr->setTextColor(0xFF0000);

4 按键类 Button

在Logic.cc中设计点击函数

static bool onButtonClick_Button1(ZKButton *pButton) {//LOGD(" ButtonClick Button1 !!!\n");return false;
}

4.1 系统按键

除了自己定义的ID值外，按键还保留了两个系统按键值：sys_back 和 sys_home ，从名字上我们大致可以知道它们的功能：返回键 和 Home键 ；点击返回键，界面会回到上一界面，如果进入了多层级的界面，点击Home键可以直接回到主界面（启动界面）。我们只需在按键的属性框中把ID值设置为 sys_back 或 sys_home ，就可以实现相应的功能。

4.2 处理按钮长按事件

这两个默认值是-1，可以进行相应设置

设置属性后，编译，打开对应的Logic.cc文件，在文件顶部，声明class LongClickListenner并继承
ZKBase::ILongClickListener类，实现virtual void onLongClick(ZKBase *pBase)方法

namespace { // 加个匿名作用域，防止多个源文件定义相同类名，运行时冲突//实现长按监听接口class LongClickListener : public ZKBase::ILongClickListener {virtual void onLongClick(ZKBase *pBase) {  LOGD("触发长按事件");static int count = 0;char buf[128] = {0};snprintf(buf, sizeof(buf), "长按事件触发次数 %d", ++count);//每次触发长按事件，修改按键的文字mLongButtonPtr->setText(buf);}};}

实例化监听类，设置为静态类型

 static LongClickListener longButtonClickListener;

在onUI_init()函数中注册按键长按监听

 static void onUI_init(){//注册按键长按监听mLongButtonPtr->setLongClickListener(&longButtonClickListener);}

在onUI_quit()中取消监听

 static void onUI_quit() {//取消按键长按监听mLongButtonPtr->setLongClickListener(NULL);}

4.3 处理按键触摸事件

实现监听接口类，继承自ITouchListener

 namespace {    // 加个匿名作用域，防止多个源文件定义相同类名，运行时冲突// 实现触摸监听接口class TouchListener : public ZKBase::ITouchListener {public:virtual void onTouchEvent(ZKBase *pBase, const MotionEvent &ev) {switch (ev.mActionStatus) {case MotionEvent::E_ACTION_DOWN:mTouchButtonPtr->setText("按下");break;case MotionEvent::E_ACTION_UP:mTouchButtonPtr->setText("抬起");break;default:break;}}};}

实例化监听类，并声明为静态类型

 static TouchListener sTouchListener;

在 static void onUI_init() 函数中注册按键触摸监听

 static void onUI_init() {//注册按键触摸监听mTouchButtonPtr->setTouchListener(&sTouchListener);}

在static void onUI_quit()函数中取消按键触摸监听

 static void onUI_quit() {//取消按键触摸监听mTouchButtonPtr->setTouchListener(NULL);}

5 复选框CheckBox

在拖入复选框后，在对应的Logic.cc中会产生关联函数，当点击控件时，关联函数会被系统调用
当点击控件时，关联函数会被调用

static void onCheckedChanged_Checkbox1(ZKCheckBox* pCheckBox, bool isChecked) {if (isChecked) {//复选框 为 选中状态LOGD("选中");} else {//复选框 为  未选中状态LOGD("未选中");} 
}

pCheckBox是该控件
isChecked时是否选中状态

6 单选组 RadioGroup

多个选项只能选择一个选项，组中选项的ID能在Activity.h中看到

在logic.cc中会自动创建关联函数

 static void onCheckedChanged_RadioGroup1(ZKRadioGroup* pRadioGroup, int checkedID) {LOGD("选中项的ID = %d", checkedID);switch (checkedID) {case ID_MAIN_RadioButton1:LOGD("第一项被选中");break;case ID_MAIN_RadioButton2:LOGD("第二项被选中");break;case ID_MAIN_RadioButton3:LOGD("第三项被选中");break;default:break;}}

checkedID是被选中的选项的ID

7 进度条，滑块

要准四张图片资源，分别是
背景图
有效图
滑块
滑块按下

7.1 如何控制滑块的进度

添加ui后，编译会自动添加在对应的.cc文件中
当进度条改变时，会自动调用函数

static void onProgressChanged_XXXX(ZKSeekBar *pSeekBar, int progress) {//LOGD("XXXX滑块的进度值变化为 %d !\n", progress);
}

设置滑块当前进度

//将滑块进度设置为28
mSeekbarPtr->setProgress(28)

获得滑块的当前进度

int progress = mSeekbarPtr->getProgress();
LOGD("当前滑块的进度值为 %s", progress);

8 指针仪表控件

需要两个图片资源，背景图和指针图片

通过代码设置指针的旋转角度

//将指针调整到90度
mPointer1Ptr->setTargetAngle(90.0);

9 列表控件

需要插入两个东西，一个是列表，一个是列表子项

有三个函数，在第一章讲过
int getListItemCount_ListView1()： 获取将要绘制列表的长度
例如: 要显示的数据有100条， 那么就返回100。
void obtainListItemData_List1： 具体设置列表每一项的显示内容 具体例子参见后续文档 以上两个函数共同控制着列表的显示内容。更具体的函数调用流程。
onListItemClick_List1： 列表控件的点击事件 当点击列表中的某一项时，系统会调用该函数，参数index 表示 当前被点击列表项的索引值。

9.1 设置列表项的显示内容

列表项，指列表组中的一个列表项中的内容

static void obtainListItemData_ListView1(ZKListView *pListView,ZKListView::ZKListItem *pListItem, int index) {//pListItem指针表示列表项， 该指针只能在这个函数内当中使用char buf[32] = {0};//参数index表示 当前绘制的是列表的第几项，从0开始。//这里，我们将index值格式化到字符串中snprintf(buf, sizeof(buf), "第%d项", index);//将字符串作为文字显示到列表项区域pListItem->setText(buf);//如果你在ui文件中，已经配置好了 列表项 "选中时的图片“，//那么，通过以下这行代码设置列表项的选中状态，即可控制列表项显示对应状态的图片pListItem->setSelected(true);
}

9.2 设置列表子项的显示内容

列表项中的列表子项

static void obtainListItemData_ListView1(ZKListView *pListView,ZKListView::ZKListItem *pListItem, int index) {char buf[32] = {0};//参数index表示 当前绘制的是列表的第几项，从0开始。//这里，我们将index值格式化到字符串中snprintf(buf, sizeof(buf), "第%d项的第一个子项", index);//我们可以通过findSubItemByID()函数以及列表子项的ID，得到列表子项的指针//与pListItem指针相同，查找得到的列表子项指针也只能在这个函数内当中使用ZKListView::ZKListSubItem* subitem1 = pListItem->findSubItemByID(ID_MAIN_SubItem1);if (subitem1 != NULL) {//设置列表子项1的文字subitem1->setText(buf);}snprintf(buf, sizeof(buf), "第%d项的第二个子项", index);ZKListView::ZKListSubItem* subitem2 = pListItem->findSubItemByID(ID_MAIN_SubItem2);if (subitem2 != NULL) {//设置列表子项2的文字subitem2->setText(buf);}
}

10 编辑框

一个可供输入的编辑框
获得模拟键盘的输入内容

static void onEditTextChanged_XXXX(const std::string &text) {//LOGD("当前输入的内容为 %s \n", text.c_str());
}// 获得字符串
const char* str = text.c_str();// 字符串转换为数字static void onEditTextChanged_EditText1(const std::string &text) {
int number = atoi(text.c_str());
LOGD("字符串转为数字 = %d", number);
}static void onEditTextChanged_EditText1(const std::string &text) {
// atof函数可以将字符串转为对应的浮点数，比如 “3.14” 可以转为整形 3.14
//如果参数不规范，会造成转换失败，统一返回 数字 0
double f = atof(text.c_str());
LOGD("字符串转为浮点数 = %f", f);
}
```cpp

11 窗口

界面中可以出现多个窗口
窗口中可以添加其他组件并自定义大小和位置

一般来说，通过触摸滑动来上下翻页，但也有相应函数

// 切换到下一页，有动画
mPageWindow1Ptr->turnToNextPage(true);
// 切换到下一页，无动画
mPageWindow1Ptr->turnToNextPage(false);// 切换到上一页，有动画
mPageWindow1Ptr->turnToPrevPage(true);
// 切换到上一页，无动画
mPageWindow1Ptr->turnToPrevPage(false);

监听翻刀了第几页

 namespace { // 加个匿名作用域，防止多个源文件定义相同类名，运行时冲突// 实现自己的监听接口class MyPageChangeListener : public ZKPageWindow::IPageChangeListener {public:virtual void onPageChange(ZKPageWindow *pPageWindow, int page) {LOGD("当前切换到第%d页", page);}};}// 定义监听对象static MyPageChangeListener sMyPageChangeListener;static void onUI_init() {mPageWindow1Ptr->setPageChangeListener(&sMyPageChangeListener);}// 获取当前是第几页
int i = mPageWindow1Ptr->getCurrentPage();
LOGD("当前是第%d页", i);

滚动窗口类似于手机主界面上下或者左右滚动的界面效果
由一个滚动窗口、一个窗口和多个控件组成

12 滑动窗口

滑动窗口中的图标会自行进行排列，也可以手动调整间距等属性

代码操作

// 切换到上一页，有动画
mSlideWindow1Ptr->turnToPrevPage(true);
// 切换到上一页，无动画
mSlideWindow1Ptr->turnToPrevPage(false);// 切换到下一页，有动画
mSlideWindow1Ptr->turnToNextPage(true);
// 切换到下一页，无动画
mSlideWindow1Ptr->turnToNextPage(false);

 namespace { // 加个匿名作用域，防止多个源文件定义相同类名，运行时冲突// 实现自己的监听接口class MySlidePageChangeListener : public ZKSlideWindow::ISlidePageChangeListener {public:virtual void onSlidePageChange(ZKSlideWindow *pSlideWindow, int page) {LOGD("当前切换到第%d页", page);}};}// 定义监听对象static MySlidePageChangeListener sMySlidePageChangeListener;static void onUI_init() {mSlidewindow1Ptr->setSlidePageChangeListener(&sMySlidePageChangeListener);}

监听后，可以自己设置点击或长按等相关操作