展讯 List控件的一些基础结构

GUILIST_ITEM_INFO_T *item_info_ptr

  │

  ├─void*              ctrl_ptr[GUIITEM_CONTENT_MAX_NUM]; //每个元素都可能内嵌控件

  ├─MMI_STRING_T       text_buffer;                       //使用大内存管理所有buffer

  └─GUILIST_ITEM_T     item;                              //用户传入的item

    │

    ├─GUIITEM_STYLE_E          item_style;        // item风格，可以指示出列表项是几行的，
    │                                              // 每行有几项内容及内容的类型（图片或文字）

    │                                              // 根据这个风格的指示，可以从s_item_style_table中
    │                                              // 取出风格所对应的GUIITEM_STYLE_T

    ├─GUIITEM_STATE_T          item_state;        // item状态

    ├─GUILIST_ITEM_DATA_T*     item_data_ptr;     // item数据

    │  │

    │  ├─MMI_TEXT_ID_T        softkey_id[GUISOFTKEY_BUTTON_NUM];        // softkey对应的文字资源id

    │  └─GUIITEM_CONTENT_T    item_content[GUIITEM_CONTENT_MAX_NUM];    // item的content,
    │      │                                                             // 最多支持双行5/6个content

    │      │

    │      ├─GUIITEM_DATA_TYPE_E         item_data_type;    // content数据类型，文字或图片

    │      └─GUIITEM_DATA_U              item_data;         // content数据结构，存放具体的文字/图片的ID或指针

    │

    └─uint32                   user_data;           /*!< 用户自定义数据*/    

   

GUIITEM_STYLE_T

  │

  ├─GUIITEM_THEME_ID_E       content_theme_id[GUIITEM_CONTENT_MAX_NUM];    // 列表item中各content的主题

  ├─GUIITEM_CONTENT_STATE_T  content_state[GUIITEM_CONTENT_MAX_NUM];       //item content state

  ├─GUIITEM_LAYOUT_ID_E      layout_id;                                    //item layout id

  └─uint16                   main_index;                                   //item main index, use for scroll

 

GUIITEM_LAYOUT_DATA_T

  │

  ├─uint16        item_height;                                  //item height

  ├─GUI_RECT_T    item_content_rect[GUIITEM_CONTENT_MAX_NUM];   //item content rect

  ├─GUI_RECT_T    item_select_icon_rect;                        //item selected icon rect

  └─GUI_RECT_T    item_num_icon_rect;                           //item num icon rect

 

画ListItem的基本流程

DrawListItem

├─GetItemInfoPtr    获取项数据的指针 item_info_ptr

├─若列表控件需要在窗口中插入项数据，而且当前项数据的指针为空，则SendNotify到窗口函数

├─MMITHEME_GetItemStyle    获取item_style_ptr GUIITEM_STYLE_T

├─GetItemThemeState    判断列表项的主题状态，如正常、高亮、无效、高亮无效

├─GetSelectIconId

├─GetNumberIconId

├─根据主题状态和GUIITEM_STYLE_T中的layout_id，从s_item_layout_id_table中提取合适的GUIITEM_LAYOUT_DATA_T

├─若整个item仅作为分隔符，则画出分隔符的背景

├─若item需要分隔线，则画分隔线

├─若需要画数字图标，则画出图标

├─画出item中的所有content

│  │

│  ├─根据列表item的主题状态和当前content的主题，来获取当前content的主题数据，如字体、颜色、字符间隔

│  ├─从GUIITEM_LAYOUT_DATA_T中提取content的区域，这个区域是相对于item区域而言的

│  ├─根据显示方向（左向右或者右向左），调整content的区域为相对于屏幕的区域

│  └─根据content数据的类型（文字或图片）进行显示

│

└─若需要画选择图标，则画出图标