触控事件

LCUI 支持触控事件，但目前仅在 Windows 系统中有效，以下是触控事件的数据结构定义：

  1. typedef struct LCUI_TouchPointRec_ {
  2.         int x;
  3.         int y;
  4.         int id;
  5.         int state;
  6.         LCUI_BOOL is_primary;
  7. } LCUI_TouchPointRec, *LCUI_TouchPoint;
  9. typedef struct LCUI_TouchEvent_ {
  10.         int n_points;
  11.         LCUI_TouchPoint points;
  12. } LCUI_TouchEvent;
  14. typedef LCUI_TouchEvent LCUI_WidgetTouchEvent;

触控事件的数据结构设计参考自 Windows API，只保留了主要的成员变量。LCUI 内部的触控事件和部件级的触控事件是一样的数据结构。

从上述代码中可以比较容易的理解到：触控事件包含多个触点的信息，n_points 表示当前共有多少个触点，每个触点都有自己的 x、y 坐标，并且有个 id 用于标识该触点，而 state 表示该触点的状态，它的值有三种：WET_TOUCHDOWN、WET_TOUCHUP、WET_TOUCHMOVE，这些值分别对应：触点按下、触点释放、触点移动这三个状态。

以下是测试触控事件的程序：

  1. /** testtouch.c -- test touch support */
  3. #include <stdio.h>
  4. #include <LCUI_Build.h>
  5. #include <LCUI/LCUI.h>
  6. #include <LCUI/graph.h>
  7. #include <LCUI/display.h>
  8. #include <LCUI/gui/widget.h>
  10. /** 触点绑定记录 */
  11. typedef struct TouchPointBindingRec_ {
  12.         int point_id;                   /**< 触点 ID */
  13.         LCUI_Widget widget;             /**< 部件 */
  14.         LinkedListNode node;            /**< 在链表中的结点 */
  15.         LCUI_BOOL is_valid;             /**< 是否有效 */
  16. } TouchPointBindingRec, *TouchPointBinding;
  18. /** 触点绑定记录列表 */
  19. static LinkedList touch_bindings;
  21. static void OnTouchWidget( LCUI_Widget w, LCUI_WidgetEvent e, void *arg )
  22. {
  23.         LCUI_TouchPoint point;
  24.         TouchPointBinding binding;
  25.         if( e->touch.n_points == 0 ) {
  26.                 return;
  27.         }
  28.         binding = e->data;
  29.         point = &e->touch.points[0];
  30.         switch( point->state ) {
  31.         case WET_TOUCHMOVE:
  32.                 Widget_Move( binding->widget, point->x - 32, point->y - 32 );
  33.                 break;
  34.         case WET_TOUCHUP:
  35.                 if( !binding->is_valid ) {
  36.                         break;
  37.                 }
  38.                 /* 当触点释放后销毁部件及绑定记录 */
  39.                 Widget_ReleaseTouchCapture( binding->widget, -1 );
  40.                 LinkedList_Unlink( &touch_bindings, &binding->node );
  41.                 binding->is_valid = FALSE;
  42.                 Widget_Destroy( w );
  43.                 free( binding );
  44.                 break;
  45.         case WET_TOUCHDOWN:
  46.         default: break;
  47.         }
  48. }
  50. static void OnTouch( LCUI_SysEvent e, void *arg )
  51. {
  52.         int i;
  53.         LinkedListNode *node;
  54.         LCUI_StyleSheet sheet;
  55.         LCUI_TouchPoint point;
  56.         for( i = 0; i < e->touch.n_points; ++i ) {
  57.                 TouchPointBinding binding;
  58.                 LCUI_BOOL is_existed = FALSE;
  59.                 point = &e->touch.points[i];
  60.                 /* 检查该触点是否已经被绑定 */
  61.                 LinkedList_ForEach( node, &touch_bindings ) {
  62.                         binding = node->data;
  63.                         if( binding->point_id == point->id ) {
  64.                                 is_existed = TRUE;
  65.                         }
  66.                 }
  67.                 if( is_existed ) {
  68.                         continue;
  69.                 }
  70.                 /* 新建绑定记录 */
  71.                 binding = NEW( TouchPointBindingRec, 1 );
  72.                 binding->widget = LCUIWidget_New( NULL );
  73.                 binding->point_id = point->id;
  74.                 binding->is_valid = TRUE;
  75.                 binding->node.data = binding;
  76.                 Widget_Resize( binding->widget, 64, 64 );
  77.                 Widget_Move( binding->widget, point->x - 32, point->y - 32 );
  78.                 /* 设置让该部件捕获当前触点 */
  79.                 Widget_SetTouchCapture( binding->widget, binding->point_id );
  80.                 Widget_BindEvent( binding->widget, "touch", OnTouchWidget, binding, NULL );
  81.                 sheet = binding->widget->custom_style;
  82.                 SetStyle( sheet, key_position, SV_ABSOLUTE,  style );
  83.                 SetStyle( sheet, key_background_color, RGB( 255, 0, 0 ), color );
  84.                 LinkedList_AppendNode( &touch_bindings, &binding->node );
  85.                 Widget_Top( binding->widget );
  86.         }
  87. }
  89. int main( int argc, char **argv )
  90. {
  91.         LCUI_Init();
  92.         LinkedList_Init( &touch_bindings );
  93.         LCUI_BindEvent( LCUI_TOUCH, OnTouch, NULL, NULL );
  94.         return LCUI_Main();
  95. }

编译后运行，如果你的计算机自带触屏，可以用手指在程序窗口内点击、移动，会看到类似于如下图所示的效果：

运行效果

这个程序实现的功能是捕获各个触点并用对应的红色方块表示触点的位置，有个 touch_bindings 全局变量用于保存各个触点和部件的绑定记录，在响应触控事件时会遍历每个触点，根据触点的 id 在绑定记录中找对应的部件，找到后会根据触点的坐标来更新部件的坐标。为了让部件能够捕获触点在它外面产生的触控事件，并且不被其它部件捕获到，调用了 Widget_SetTouchCapture() 函数实现对该触点的独占，在触点释放后，调用 Widget_ReleaseTouchCapture() 函数解除对触点的独占。

原文: https://docs.lcui.lc-soft.io/zh-cn/gui_events/touch.html