继承

有时候会发现某个部件的功能不够用，想扩展一些新功能，但不想直接修改它的代码，也不想重写一个新部件，这个时候可以使用原型的“继承”功能来创建一个该部件的扩展版本，即能保留原部件的功能，又能使用新加的功能。

以 textview 部件为例，现在有这样的功能需求：能够支持设置网址链接，在被点击时会调用浏览器打开这个链接，网址链接能靠 href 属性来设置，以下是示例代码：

  1. #include <string.h>
  2. #include <stdlib.h>
  3. #include <LCUI_Build.h>
  4. #include <LCUI/LCUI.h>
  5. #include <LCUI/gui/widget.h>
  7. typedef struct LinkRec_ {
  8.         char *href;
  9. } LinkedRec, *Link;
  11. LCUI_WidgetPrototype prototype;
  13. static void Link_OnClick( LCUI_Widget w, LCUI_WidgetEvent e, void *arg )
  14. {
  15.         Link link = Widget_GetData( w, prototype );
  16.         if( link->href ) {
  17.                 // 调用浏览器打开链接
  18.                 // ...
  19.         }
  20. }
  22. static void Link_OnInit( LCUI_Widget w )
  23. {
  24.         Link link;
  25.         const size_t size = sizeof( LinkRec );
  26.         link = Widget_AddData( w, prototype, size );
  28.         link->href = NULL;
  29.         Widget_BindEvent( w, "click", Link_OnClick, NULL, NULL );
  30.         // 调用父级原型的 init() 方法，继承父级现有的功能
  31.         prototype->proto->init( w );
  32. }
  34. static void Link_OnDestroy( LCUI_Widget w )
  35. {
  36.         Link link = Widget_GetData( w, prototype );
  37.         free( link->href );
  38.         prototype->proto->destroy( w );
  39. }
  41. void Link_SetHref( LCUI_Widget w, const char *href )
  42. {
  43.         Link link = Widget_GetData( w, prototype );
  44.         if( link->href ) {
  45.                 free( link->href );
  46.                 link->href = NULL;
  47.         }
  48.         if( href ) {
  49.                 size_t len = strlen( href ) + 1;
  50.                 link->href = malloc( len * sizeof( char ) );
  51.                 strcpy( link->href, href );
  52.         }
  53. }
  55. static void Link_OnSetAttr( LCUI_Widget w, const char *name, const char *value )
  56. {
  57.         // 当 XML 解析器解析到的元素属性是 href 时
  58.         if( strcmp( name, "href" ) == 0 ) {
  59.                 Link_SetHref( w, value );
  60.         }
  61. }
  63. void LCUIWidget_AddLink( void )
  64. {
  65.         // 创建一个名为 link 的部件原型，继承自 textview
  66.         prototype = LCUIWidget_NewPrototype( "link", "textview" );
  67.         prototype->init = Link_OnInit;
  68.         prototype->destroy = Link_OnDestroy;
  69.         prototype->setattr = Link_OnSetAttr;
  70. }

以上代码创建了一个名为 link 的部件原型，接下来将展示如何使用它：

  1. // ...
  2. LCUI_Widget link;
  3. LCUIWidget_AddLink();
  4. // ...
  5. link = LCUIWidget_New( "link" );
  6. Link_SetHref( link, "https://www.example.com" );
  7. // ...
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <lcui-app>
  3.   <ui>
  4.     <widget type="link" href="https://www.example.com">点击这里</widget>
  5.   </ui>
  6. </lcui-app>

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