你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

基于STM32的TouchGFX 控件附加 ClickListener 功能的方法介绍

[复制链接]
STMCU小助手 发布时间:2023-11-19 12:42
01引言: f2 t( Z2 ~, ^# e6 `
TouchGFX 是专用于 STM32 的图形界面设计软件,可用来低成本开发优秀的图形界面,TouchGFX 现已变的越来越流行。为了帮助客户更加深入地理解和使用 TouchGFX ,本文介绍了 TouchGFX Designer 中的 Mixin 功能,从基础示例 Button Example 出发,为文本框控件添加 ClickListener (Mixin 功能中的一项),并对源代码进行简单剖析。期望能帮助客户更深入地理解 STM32 TouchGFX 的相关功能。
) h0 z" i5 Z" s; \% ~4 z) d4 {2 p* P3 b

6 q% O3 Z6 `  S2 ^02TouchGFX ClickListener 模板的使用/ S2 F' A; ?( t4 T. G
2.1. C++模板编程基础
- ~7 a9 p7 E8 d* Z: y- ^在示例介绍之前,让我们先熟悉一下 C++模板编程的一些基础知识。模板编程属于通用编程的范畴,是为“尚未确定类型”所写的函数或类。是可以产生更干净、更快速、更精明的软件的一个强力手段。& m+ G( _& b" s& M: d! f/ n
! j8 L9 e3 y) m# o3 q7 p; l
模板的优点:首先模板与某种特定类型无关,代码可重用性好;其次模板与平台无关,代码移植性好;另外模板代码在编译时才进行解释,在编译时确定检查数据类型,相比运行时检查,类型的安全性高。
) b3 R- t7 H% ]3 @0 B, p
6 Q2 k3 G4 r  c, o1 n模板的缺点:一是代码易读性不是很好,调试不便;二是用户工程代码中需要包含模板代码(非二进制库),编译的时间较长,二进制扩展性差;另外有可能会造成二进制代码膨胀(编译后二进制代码臃肿),我们在设计模板时,需要尽可能将 C++模板中与参数⽆关的代码分离出来。
2 E- o. r) a9 s, l2 \* A5 `3 Q& t5 H6 Z. Z4 E3 i9 `  o0 _
( a+ U, G) o, a; K4 |( o
2.2. TouchGFX Mixin 功能简介
' l3 v# y8 }0 G, f$ c模板一般分为函数模板和类模板。函数模板我们这里不做赘述,重点关注 TouchGFX Mixins 类模板。TouchGFX 的 Mixins 类模板用于拓展控件的功能,目前 TouchGFX v4.20.0 中有四个 Mixin 功能,分别是 Draggable、ClickListener、FadeAnimator 和MoveAnimator,分别为控件增添相关功能。如图 1 (TouchGFX Designer Mixins 功能)所示,本文主要针对 ClickListener 做具体介绍。
& S- B+ T( M" q! U
3 I- X7 b# o: h% B; `% ]8 I
微信图片_20231119124128.jpg
& N" Q+ c9 v' o
图1. TouchGFX Designer Mixins 功能

5 s1 R& v# O: p) A$ W5 {/ H

1 Q, z( R$ `: j# s2.3. 基于 TouchGFX Button 例程使用 ClickListener 功能

3 k- A1 q% K' E3 |2.3.1. TouchGFX 例程的代码生成
4 D2 L9 q7 b3 T, n/ r运行 TouchGFX Designer,选择 Examples;通过 Select Board Setup 选择STM32H735G DK 板;从众多例程中选择“Button Example”例程;将 Application name 改为 Button_Example,如下图图 2,然后点击 Create 创建工程。
& q; h. n# t/ b4 Z- Q% H6 r! _% T- j& ]
微信图片_20231119124125.jpg

- ~' S  N. F: h3 r0 {, x
图2.TouchGFX Designer 生成 Button Example 例程
( I3 r. m) V& `9 \

1 x# i( l+ ~) V, o9 c) M9 r/ F2 i进入 TouchGFX Designer 主界面后,会看到画布上有两个按钮和一个文本框,我们对界面不做更改,直接选择 Designer 右下角 (Run Target)生成代码。该操作将会复制TouchGFX 框架文件,生成配置文件、makefile、代码及资源文件(images、fonts、texts),然后编译链接、烧录目标板并运行。程序运行起来后,您可以熟悉一下该按钮例程应用。下面我们就针对该例程,为界面上的计数文本框控件注入 ClickListener 功能,应用实现“当点击计数文本框时,计数数字增加 2”的功能。" S* W$ y8 H+ q' j
) P: L4 L! p* Z$ a/ s- L' d

8 ]: q/ G1 b- {, v7 q8 E% s2 g+ g0 s2.3.2. 为计数文本框控件添加 ClickListener 功能. C- M5 m5 @' z# h1 Q
我们在 TouchGFX Designer 主屏界面,点击 countTxt 文本框,然后在右侧属性栏中找到 Mixins,勾选 ClickListener,如图 3 所示。然后重新生成代码。
( }4 ]8 a( o: U+ r. n
5 T# l: q. }' l  {
微信图片_20231119124122.jpg

- E; ^( k$ k: T# M( i
图3.TouchGFX Designer, 计数文本框 mixin ClickListener 功能
; ^, d1 v, H! A; m$ B4 c1 w3 X8 r
' E; b: f4 F. Q
我们可以使用 VS code 编辑代码,或使用其它如 STM32CubeIDE 等工具编辑代码。打开 MainView.hpp,为计数文本框,添加代码如下(黄底色部分):0 K& ^  h1 W- L8 e4 D. z2 }
. O- _3 ]& _/ k+ s+ b% ]
微信图片_20231119124119.jpg

& e8 d8 @* W& N3 I: i6 N
微信图片_20231119124116.jpg
- ?( U6 E! m! a% y8 C; S
. [$ K, [* z1 ~& k. ^+ e* [0 S
然后我们转到 MainView.cpp 文件,首先将 txtClickedCallback 对象与 MainView的 cntTextClickHandler(文本框点击处理函数)绑定,这是在 MainView 类的构造函数中初始化列表中实现的。将 txtClickedCallback 加入初始化列表中,参数使用指向MainView 中 cntTextClickHandler 函数的函数指针。我们还需要修改 setupScreen 函数,在这里为 countTxt 添加 ClickAction,参数使用 txtClickedCallback, 以实现在主屏界面创建时,将 countTxt 文本框的点击事件与 txtClickedCallback 对象绑定在一起。另外我们还需要实现 cntTextClickHandler,具体代码如下:) u* \+ j% u( k" T9 f* ~. r

  s+ f* W$ A9 k+ i5 Y6 n
微信图片_20231119124113.jpg

! Q$ I) {6 C" }+ o) ~% m% n
/ a$ |6 A9 o# }& l
修改完成后,保存,编译,运行。您将会发现当每次点击 countTxt 文本框时,文本框计数会增加 2。至此,我们已经实现了为文本框控件加入 ClickListener 的功能。大家可以看到,在 TouchGFX 应用中使用 ClickListener 类模板做开发是十分便捷的,代码量也较小。下面我们对代码进一步解读。) \, J+ A/ e' _$ p5 Q) L5 v, A
6 `( f, Y, a- B7 t
2.3.3. ClickListener 模板代码* e1 d# g2 L0 n2 C% r5 ^
ClickListener 类模板是 TouchGFX 框架的一部分,封装在 ClickListener.hpp 中,代码如下:
5 S4 U0 a9 z/ z0 c3 f. H# ~7 p; P1 k4 x
微信图片_20231119124109.jpg
+ D/ O6 t( l8 g- g* n1 J
微信图片_20231119124106.jpg
; u+ @  n' d) t, R# I
8 d9 C1 A0 G) w3 V( U: V
ClickListener 是一个标准的类模板。所谓类模板,就是“包含一个或多个尚未确定类型”的类。必须将具体类型当作模板参数传入,才可使用。当传入模板参数后,该类模板便以你所指定的参数类型,由编译器进行实例化。将具体类型传入到类模板进行实例化,我们会得到一个新的 ClickListener 类,转变为从传入参数(某待定的类)的派生类。 # K# \% @0 \: Y7 [- @1 m% w: ~

8 R2 l+ `- m! K  J' u; f4 c5 f 在生成的代码 MainViewBase.hpp 中(MainView 是 MainViewBase 的派生类),我们可以找到 countTxt 的声明:. [) J' Z' e2 q6 ]( V  c% Z: o" c% F

+ B& U4 n9 R4 T) j5 I( m  Y* gtouchgfx::ClickListener< touchgfx::TextAreaWithOneWildcard > countTxt;1 R. R) H% x% E3 }& `' _2 `$ b
! F: m4 ~' G- ]
这里,该模板示例类是从 TextAreaWithOneWildcard 类(即原计数文本框类型)继承下来的。如果您选择的不是为文本框增加 ClickListener 功能,而是其它控件,则新的ClickListener 实例类将派生自您所用的控件。本例中的继承关系如下:
4 S( m( J$ _7 F) G/ W. h
微信图片_20231119124102.jpg
! u3 h  h* i7 c! @6 q# f

3 Q9 \* ?: B' E5 @该 ClickListener 实例类是 TextAreaWithOneWildcard 类的派生类,不仅仅继承了TextAreaWithOneWildcard 的属性与方法,另外还添加了一个 GenericCallback 指针变量clickAction,该指针由附加的 setClickAction 方法赋值。由另一个方法 handleClickEvent使用,在 handleClickEvent 中在响应 Click 事件时,会调用该 clickAction。(关于callback 类的使用,我们这里不做赘述,如果您需要进一步了解,请参考 TouchGFX 相关文档)。! S' j; [; @- m/ N1 z( v. L
# [; z  k9 n3 m
2.3.4. ClickListener 模板应用3 H* m1 E# ~4 g7 \0 l* T) p
我们清楚了 ClickListener 类模板的原理后,回头来看例子中的 ClickListener 的应用代码,就会发现其逻辑十分清晰。+ Q3 _3 |& z+ U2 S, z& Q1 t& c
9 f' g" h8 N2 ]8 O% e+ V
首先在 MainView.hpp 中声明了一个 Callback txtClickedCallback, 和一个事件处理函数 cntTextClickHandler。在 MainView.cpp 中初始化该 txtClickedCallback, 将其与cntTextClickHandler 关联,即实现当调用该 Callback 时,会转到 cntTextClickHandler 进行处理。% x8 r# z8 q/ _8 b  ]2 w

4 v6 A6 g! f1 m5 O7 `再在 setupScreen 函数中调用 ClickListener 类模板接口 setClickAction 将txtClickedCallback 的地址赋给 ClickListener 实例化类的 clickAction 指针。则ClickListener 实例化类(这里即 TextAreaWithOneWildcard 类的派生类)在处理ClickEvent 时就会执行到 txtClickedCallback 关联的处理函数 cntTextClickHandler5 z! j9 b* Q7 u# I$ I. c3 j
& I& G8 Z$ M0 M( B
最后需要实现 MainView 类中的 Click 事件处理函数 cntTextClickHandler,这里的实现为:当 Click 事件类型为“Click 按键释放”时调用 increaseValue 函数两次。
6 U! x2 y4 G4 l* T
/ {8 D* K7 \" P  \
03小结
: ~0 X  m1 w+ r" aTouchGFX 是 STM32 专用的界面设计工具,功能强大且易用。本文选择了 Mixins 功能进行简介,从基础示例 Button Example 出发,动手添加 ClickListener (Mixin) 功能,并从源代码的角度浅析了 ClickListener 类模板的使用,助力客户更深入地理解 STM32 TouchGFX。3 m& z2 I: b  ?$ ~& ?% }

: ~$ h9 U: Z& {1 S3 J. t转载自: STM32单片机
+ l: V  C& h/ E2 I$ l" M如有侵权请联系删除
2 ~. ~/ Z7 `( U" L
! U3 p; c: L* E( G7 K+ g7 Z) X5 m
赞 收藏 评论0 发布时间:2023-11-19 12:42

举报

0个回答
关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版