update api comments

src/base/widget.c

@@ -1371,7 +1371,7 @@ ret_t widget_stroke_border_rect(widget_t* widget, canvas_t* c, rect_t* r) {
   return RET_OK;
 }
 
-static ret_t widget_draw_background(widget_t* widget, canvas_t* c) {
+ret_t widget_draw_background(widget_t* widget, canvas_t* c) {
   rect_t r;
   return_value_if_fail(widget != NULL && c != NULL, RET_BAD_PARAMS);
 

src/base/widget.h

@@ -1881,6 +1881,16 @@ bool_t widget_is_keyboard(widget_t* widget);
  */
 ret_t widget_paint_helper(widget_t* widget, canvas_t* c, const char* icon, wstr_t* text);
 
+/**
+ * @method widget_draw_background
+ * 根据控件的style绘制背景矩形。
+ * @param {widget_t*} widget 控件对象。
+ * @param {canvas_t*} c 画布对象。
+ *
+ * @return {ret_t} 返回RET_OK表示成功，否则表示失败。
+ */
+ret_t widget_draw_background(widget_t* widget, canvas_t* c);
+
 /**
  * @method widget_stroke_border_rect
  * 根据控件的style绘制边框矩形。

tools/idl_gen/idl.json

@@ -19991,6 +19991,27 @@
           "desc": "返回RET_OK表示成功，否则表示失败。"
         }
       },
+      {
+        "params": [
+          {
+            "type": "widget_t*",
+            "name": "widget",
+            "desc": "控件对象。"
+          },
+          {
+            "type": "canvas_t*",
+            "name": "c",
+            "desc": "画布对象。"
+          }
+        ],
+        "annotation": {},
+        "desc": "根据控件的style绘制背景矩形。",
+        "name": "widget_draw_background",
+        "return": {
+          "type": "ret_t",
+          "desc": "返回RET_OK表示成功，否则表示失败。"
+        }
+      },
       {
         "params": [
           {