slide_menu_t

概述

左右滑动菜单控件。

一般用一组按钮作为子控件，通过左右滑动改变当前的项。除了当菜单使用外，也可以用来切换页面。

slide_menu_t是widget_t的子类控件，widget_t的函数均适用于slide_menu_t控件。

在xml中使用”slide_menu”标签创建左右滑动菜单控件。如：

 <slide_menu style="mask" align_v="top">
  <button style="slide_button" text="0"/>
   <button style="slide_button" text="1"/>
   <button style="slide_button" text="2"/>
   <button style="slide_button" text="3"/>
   <button style="slide_button" text="4"/>
 </slide_menu>

更多用法请参考：slide_menu.xml

在c代码中使用函数slide_menu_create创建左右滑动菜单控件。如：

 slide_menu = slide_menu_create(win, 10, 10, 300, 60);
 b = button_create(slide_menu, 0, 0, 0, 0);
 widget_set_text_utf8(b, "1");
 b = button_create(slide_menu, 0, 0, 0, 0);
 widget_set_text_utf8(b, "2");
 b = button_create(slide_menu, 0, 0, 0, 0);
 widget_set_text_utf8(b, "3");
 b = button_create(slide_menu, 0, 0, 0, 0);
 widget_set_text_utf8(b, "4");

可按下面的方法关注当前项改变的事件：

 widget_on(slide_menu, EVT_VALUE_CHANGED, on_current_changed, slide_menu);

可按下面的方法关注当前按钮被点击的事件：

 widget_on(b, EVT_CLICK, on_button_click, b);

完整示例请参考：slide_menu demo

可用通过style来设置控件的显示风格，如背景颜色和蒙版颜色等等。如：

 <style name="mask">
   <normal     bg_color="#f0f0f0" mask_color="#f0f0f0"/>
 </style>

更多用法请参考：theme default

函数

属性

事件

slide_menu_cast 函数

• 函数功能：

转换slide_menu对象(供脚本语言使用)。

• 函数原型：

widget_t* slide_menu_cast (widget_t* widget);

• 参数说明：

slide_menu_create 函数

• 函数功能：

创建slide_menu对象

• 函数原型：

widget_t* slide_menu_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);

• 参数说明：

slide_menu_set_align_v 函数

• 函数功能：

设置垂直对齐方式。

• 函数原型：

ret_t slide_menu_set_align_v (widget_t* widget, align_v_t align_v);

• 参数说明：

slide_menu_set_min_scale 函数

• 函数功能：

设置最小缩放比例。

• 函数原型：

ret_t slide_menu_set_min_scale (widget_t* widget, float_t min_scale);

• 参数说明：

slide_menu_set_value 函数

• 函数功能：

设置当前项。

• 函数原型：

ret_t slide_menu_set_value (widget_t* widget, uint32_t value);

• 参数说明：

align_v 属性

垂直对齐方式。

• 类型：align_v_t

min_scale 属性

最小缩放比例。

• 类型：float_t

value 属性

值。代表当前选中项的索引。

• 类型：int32_t