私有数据

一个部件的各种功能的实现都会用到数据，例如：文本编辑框，它会保存当前编辑的文本内容，调用相关函数可以对这个文本内容进行读写操作，在绘制时也会需要用到这些文本内容以在屏幕上绘制出相应的文字。

部件私有数据的操作函数有以下两个：

  1. void *Widget_AddData( LCUI_Widget widget, LCUI_WidgetPrototype proto, size_t data_size );
  2. void *Widget_GetData( LCUI_Widget widget, LCUI_WidgetPrototype proto );

从以上代码中可以看出部件私有数据有添加和获取这两种方法，私有数据是与部件原型绑定的，添加时需要指定具体的内存占用大小。添加后，可以调用 Widget_GetData() 函数获取私有数据，这个函数也同样需要指定原型。

以下是这两个函数的基本用法示例：

  1. #include <stdio.h>
  2. #include <stdlib.h>
  3. #include <string.h>
  4. #include <LCUI_Build.h>
  5. #include <LCUI/LCUI.h>
  6. #include <LCUI/gui/widget.h>
  8. /** 部件私有数据的结构 */
  9. typedef struct MyWidgetRec_ {
  10.     int a;
  11.     char b;
  12.     double c;
  13.     char *str;
  14. } MyWidgetRec, *MyWidget;
  16. static struct MyWidgetModule {
  17.         LCUI_WidgetPrototype prototype;
  18.         // 其它用得到的数据
  19.         // xxxx
  20.         // ...
  21. } self;
  23. static void MyWidget_OnInit( LCUI_Widget w )
  24. {
  25.         MyWidget data;
  26.         const size_t size = sizeof( MyWidgetRec );
  27.         data = Widget_AddData( w, self.prototype, size );
  28.         // 初始化私有数据
  29.         data->a = 123;
  30.         data->b = 'b';
  31.         data->c = 3.1415926;
  32.         data->str = malloc( 256 * sizeof(char) );
  33.         strcpy( data->str, "this is my widget." );
  34.         printf( "my widget is inited.\n" );
  35. }
  37. static void MyWidget_OnDestroy( LCUI_Widget w )
  38. {
  39.         MyWidget data = Widget_GetData( w, self.prototype );
  40.         // 释放私有数据占用的内存资源
  41.         free( data->str );
  42.         printf( "my widget is destroied.\n" );
  43. }
  45. void LCUIWidget_AddMyWidget( void )
  46. {
  47.         int i;
  48.         self.prototype = LCUIWidget_NewPrototype( "mywidget", NULL );
  49.         self.prototype->init = MyWidget_OnInit;
  50.         self.prototype->destroy = MyWidget_OnDestroy;
  51.         // 如果全局用得到的数据的话
  52.         // self.xxxx = ???
  53. }

原文: https://docs.lcui.lc-soft.io/zh-cn/gui_widgets/data.html