[ { "type": "class", "methods": [ { "params": [ { "type": "event_t*", "name": "event", "desc": "event对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为event对象。\n\n> 供脚本语言使用", "name": "event_cast", "return": { "type": "event_t*", "desc": "event对象。" } }, { "params": [ { "type": "uint32_t", "name": "type", "desc": "事件类型。" } ], "annotation": { "constructor": true, "scriptable": true, "gc": true }, "desc": "创建event对象。\n\n主要给脚本语言使用。", "name": "event_create", "return": { "type": "event_t*", "desc": "返回事件对象。" } }, { "params": [ { "type": "event_t*", "name": "event", "desc": "event对象。" } ], "annotation": { "deconstructor": true, "scriptable": true, "gc": true }, "desc": "销毁事件对象。\n\n主要给脚本语言使用。", "name": "event_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "uint32_t", "name": "type", "desc": "事件类型。" }, { "type": "void*", "name": "target", "desc": "目标对象。" } ], "annotation": { "constructor": true }, "desc": "初始化事件。", "name": "event_init", "return": { "type": "event_t", "desc": "事件对象。" } } ], "events": [], "properties": [ { "name": "type", "desc": "类型。", "type": "int32_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "time", "desc": "事件发生的时间。", "type": "uint64_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "target", "desc": "事件发生的目标对象。", "type": "void*", "annotation": { "readable": true, "scriptable": true } } ], "header": "tkc/event.h", "desc": "事件基类。", "name": "event_t", "order": -100, "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" }, { "type": "wh_t", "name": "w", "desc": "宽度。" }, { "type": "wh_t", "name": "h", "desc": "高度。" } ], "annotation": { "constructor": true, "scriptable": true, "gc": true }, "desc": "创建rect对象。\n\n> 主要供脚本语言使用。", "name": "rect_create", "return": { "type": "rect_t*", "desc": "rect对象。" } }, { "params": [ { "type": "rect_t*", "name": "rect", "desc": "rect对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" }, { "type": "wh_t", "name": "w", "desc": "宽度。" }, { "type": "wh_t", "name": "h", "desc": "高度。" } ], "annotation": { "scriptable": true }, "desc": "设置rect对象的xywh。\n\n> 主要供脚本语言使用。", "name": "rect_set", "return": { "type": "rect_t*", "desc": "rect对象。" } }, { "params": [ { "type": "rect_t*", "name": "rect", "desc": "rect对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为rect对象。\n\n> 供脚本语言使用。", "name": "rect_cast", "return": { "type": "rect_t*", "desc": "rect对象。" } }, { "params": [ { "type": "rect_t*", "name": "r", "desc": "rect对象。" } ], "annotation": { "deconstructor": true, "scriptable": true, "gc": true }, "desc": "销毁rect对象。\n\n> 主要供脚本语言使用。", "name": "rect_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "rect_t*", "name": "r", "desc": "rect对象。" }, { "type": "float_t", "name": "scale", "desc": "缩放比例。" } ], "annotation": {}, "desc": "缩放rect对象。", "name": "rect_scale", "return": { "type": "rect_t*", "desc": "返回rect对象。" } }, { "params": [ { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" }, { "type": "wh_t", "name": "w", "desc": "宽度。" }, { "type": "wh_t", "name": "h", "desc": "高度。" } ], "annotation": {}, "desc": "初始化rect对象。", "name": "rect_init", "return": { "type": "rect_t", "desc": "返回rect对象。" } }, { "params": [ { "type": "rect_t*", "name": "dst_r", "desc": "rect对象。" }, { "type": "const rect_t*", "name": "r", "desc": "rect对象。" } ], "annotation": {}, "desc": "合并两个rect对象。", "name": "rect_merge", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "rect_t*", "name": "r", "desc": "rect对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" } ], "annotation": {}, "desc": "判断指定的点在rect范围内。", "name": "rect_contains", "return": { "type": "bool_t", "desc": "返回在rect范围内。" } }, { "params": [ { "type": "rect_t*", "name": "r", "desc": "rect对象。" } ], "annotation": {}, "desc": "确保rect在指定的大小范围内。", "name": "rect_fix", "return": { "type": "rect_t", "desc": "返回修复之后的rect对象。" } }, { "params": [ { "type": "const rect_t*", "name": "r1", "desc": "rect对象。" }, { "type": "const rect_t*", "name": "r2", "desc": "rect对象。" } ], "annotation": {}, "desc": "求两个rect的交集。", "name": "rect_intersect", "return": { "type": "rect_t", "desc": "返回交集。" } } ], "events": [], "properties": [ { "name": "x", "desc": "x坐标。", "type": "xy_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "y", "desc": "y坐标。", "type": "xy_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "w", "desc": "宽度。", "type": "wh_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "h", "desc": "高度。", "type": "wh_t", "annotation": { "readable": true, "scriptable": true } } ], "header": "tkc/rect.h", "desc": "矩形。包括一个x坐标、y坐标、宽度和高度。", "name": "rect_t", "order": -10, "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "x", "desc": "x坐标。", "type": "float_t", "annotation": { "readable": true } }, { "name": "y", "desc": "y坐标。", "type": "float_t", "annotation": { "readable": true } } ], "header": "tkc/rect.h", "desc": "点(浮点数)。包括一个x坐标和一个y坐标。", "name": "pointf_t", "order": -10, "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "x", "desc": "x坐标。", "type": "xy_t", "annotation": { "readable": true } }, { "name": "y", "desc": "y坐标。", "type": "xy_t", "annotation": { "readable": true } } ], "header": "tkc/rect.h", "desc": "点。包括一个x坐标和一个y坐标。", "name": "point_t", "annotation": { "scriptable": true }, "order": -10, "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true, "scriptable": true, "gc": true }, "desc": "创建emitter对象。", "name": "emitter_create", "return": { "type": "emitter_t*", "desc": "对象。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" } ], "annotation": { "constructor": true }, "desc": "初始化emitter对象。", "name": "emitter_init", "return": { "type": "emitter_t*", "desc": "对象。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "event_t*", "name": "e", "desc": "事件对象。" } ], "annotation": { "scriptable": true }, "desc": "分发事件。如果当前分发的回调函数返回RET_REMOVE，该回调函数将被移出。\n禁用状态下，本函数不做任何事情。", "name": "emitter_dispatch", "return": { "type": "ret_t", "desc": "如果当前分发的回调函数返回RET_STOP，dispatch中断分发，并返回RET_STOP，否则返回RET_OK。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型。" } ], "annotation": { "scriptable": true }, "desc": "分发事件。\n> 对emitter_dispatch的包装，分发一个简单的事件。\n如果当前分发的回调函数返回RET_STOP，dispatch中断分发，并返回RET_STOP，否则返回RET_OK。", "name": "emitter_dispatch_simple_event", "return": { "type": "ret_t", "desc": "" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型。" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": { "scriptable": "custom" }, "desc": "注册指定事件的处理函数。", "name": "emitter_on", "return": { "type": "uint32_t", "desc": "返回id，用于emitter_off。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型。" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": {}, "desc": "判断指定的事件和回调函数是否已经注册。", "name": "emitter_exist", "return": { "type": "bool_t", "desc": "返回TRUE表示已经注册，否则表示没有注册。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型。" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" }, { "type": "uint32_t", "name": "tag", "desc": "tag。" } ], "annotation": {}, "desc": "注册指定事件的处理函数。", "name": "emitter_on_with_tag", "return": { "type": "uint32_t", "desc": "返回id，用于emitter_off。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "uint32_t", "name": "id", "desc": "emitter_on返回的ID。" } ], "annotation": { "scriptable": true }, "desc": "注销指定事件的处理函数。", "name": "emitter_off", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型。" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": {}, "desc": "注销指定事件的处理函数。", "name": "emitter_off_by_func", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": {}, "desc": "注销指定事件的处理函数。", "name": "emitter_off_by_ctx", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "uint32_t", "name": "tag", "desc": "tag。" } ], "annotation": {}, "desc": "注销指定事件的处理函数。", "name": "emitter_off_by_tag", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "uint32_t", "name": "id", "desc": "emitter_on返回的ID。" }, { "type": "tk_destroy_t", "name": "on_destroy", "desc": "回调函数。" }, { "type": "void*", "name": "on_destroy_ctx", "desc": "回调函数上下文。" } ], "annotation": {}, "desc": "设置一个回调函数，在emitter被销毁时调用(方便脚本语言去释放回调函数)。", "name": "emitter_set_on_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" }, { "type": "uint32_t", "name": "id", "desc": "emitter_on返回的ID。" } ], "annotation": {}, "desc": "通过ID查找emitter_item_t，主要用于辅助测试。", "name": "emitter_find", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" } ], "annotation": { "scriptable": true }, "desc": "启用。", "name": "emitter_enable", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" } ], "annotation": { "scriptable": true }, "desc": "禁用。\n\n禁用后emitter_dispatch无效，但可以注册和注销。", "name": "emitter_disable", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" } ], "annotation": { "scriptable": true }, "desc": "获取注册的回调函数个数，主要用于辅助测试。", "name": "emitter_size", "return": { "type": "uint32_t", "desc": "回调函数个数。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" } ], "annotation": { "deconstructor": true }, "desc": "析构。", "name": "emitter_deinit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" } ], "annotation": { "deconstructor": true, "scriptable": true, "gc": true }, "desc": "销毁。", "name": "emitter_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "emitter_t*", "name": "emitter", "desc": "emitter对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为emitter对象(供脚本语言使用)。\n\n主要给脚本语言使用。", "name": "emitter_cast", "return": { "type": "emitter_t*", "desc": "对象。" } }, { "params": [ { "type": "void*", "name": "ctx", "desc": "emitter对象。" }, { "type": "event_t*", "name": "e", "desc": "分发的事件。" } ], "annotation": {}, "desc": "分发事件", "name": "emitter_forward", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "items", "desc": "注册的回调函数集合。", "type": "emitter_item_t*", "annotation": { "private": true } }, { "name": "next_id", "desc": "下一次emitter_on返回的ID，emitter_on成功后会自动增加next_id。", "type": "uint32_t", "annotation": { "private": true } }, { "name": "enable", "desc": "禁用标志。禁用时dispatch无效。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "remove_curr_iter", "desc": "如果在回调函数中，emitter_off当前正在dispatch的回调函数，\n我们只是设置remove_curr_iter为TRUE，在分发完成后才执行。\nXXX: 如果要注销当前正在dispatch的回调函数，直接返回RET_REMOVE是最好的选择。", "type": "bool_t", "annotation": { "private": true } }, { "name": "curr_iter", "desc": "当前正在dispatch的项。", "type": "emitter_item_t*", "annotation": { "private": true } } ], "header": "tkc/emitter.h", "desc": "事件分发器, 用于实现观察者模式。", "name": "emitter_t", "order": -10, "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true, "scriptable": true, "gc": true }, "desc": "创建图片对象(一般供脚本语言中使用)。", "name": "bitmap_create", "return": { "type": "bitmap_t*", "desc": "返回bitmap对象。" } }, { "params": [ { "type": "uint32_t", "name": "w", "desc": "宽度。" }, { "type": "uint32_t", "name": "h", "desc": "高度。" }, { "type": "uint32_t", "name": "line_length", "desc": "line_length。" }, { "type": "bitmap_format_t", "name": "format", "desc": "格式。" } ], "annotation": { "constructor": true, "scriptable": true, "gc": true }, "desc": "创建图片对象。", "name": "bitmap_create_ex", "return": { "type": "bitmap_t*", "desc": "返回bitmap对象。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" } ], "annotation": { "scriptable": true }, "desc": "获取图片一个像素占用的字节数。", "name": "bitmap_get_bpp", "return": { "type": "uint32_t", "desc": "返回一个像素占用的字节数。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" } ], "annotation": {}, "desc": "为读取数据而锁定bitmap的图片缓冲区。", "name": "bitmap_lock_buffer_for_read", "return": { "type": "uint8_t*", "desc": "返回缓存区的首地址。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" } ], "annotation": {}, "desc": "为修改数据而锁定bitmap的图片缓冲区。", "name": "bitmap_lock_buffer_for_write", "return": { "type": "uint8_t*", "desc": "返回缓存区的首地址。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" } ], "annotation": {}, "desc": "解锁图像缓冲区。", "name": "bitmap_unlock_buffer", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" }, { "type": "uint32_t", "name": "x", "desc": "x坐标。" }, { "type": "uint32_t", "name": "y", "desc": "y坐标。" }, { "type": "rgba_t*", "name": "rgba", "desc": "返回颜色值。" } ], "annotation": {}, "desc": "获取图片指定像素的rgba颜色值(主要用于测试程序)。", "name": "bitmap_get_pixel", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" }, { "type": "uint32_t", "name": "line_length", "desc": "line_length。" } ], "annotation": {}, "desc": "设置line_length。", "name": "bitmap_set_line_length", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" } ], "annotation": {}, "desc": "获取每一行占用内存的字节数。", "name": "bitmap_get_line_length", "return": { "type": "ret_t", "desc": "返回每一行占用内存的字节数。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" }, { "type": "uint32_t", "name": "w", "desc": "宽度。" }, { "type": "uint32_t", "name": "h", "desc": "高度。" }, { "type": "bitmap_format_t", "name": "format", "desc": "格式。" }, { "type": "const uint8_t*", "name": "", "desc": "a" }, { "type": "uint32_t", "name": "comp", "desc": "颜色通道数(目前支持3(rgb)和4(rgba))。" } ], "annotation": {}, "desc": "初始化图片。\n数据。3通道时为RGB888格式，4通道时为RGBA888格式(内部拷贝该数据，不会引用，调用者自行释放)。", "name": "bitmap_init_from_rgba", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" }, { "type": "uint32_t", "name": "w", "desc": "宽度。" }, { "type": "uint32_t", "name": "h", "desc": "高度。" }, { "type": "bitmap_format_t", "name": "format", "desc": "格式。" }, { "type": "const uint8_t*", "name": "data", "desc": "数据，直接引用，但不负责释放。如果为空，由内部自动分配和释放。" } ], "annotation": {}, "desc": "初始化图片。", "name": "bitmap_init", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" }, { "type": "const char*", "name": "filename", "desc": "文件名。" } ], "annotation": {}, "desc": "把bitmap保存为png。", "name": "bitmap_save_png", "return": { "type": "bool_t", "desc": "返回TRUE表示成功，FALSE表示失败。" } }, { "params": [ { "type": "const uint8_t*", "name": "buff", "desc": "数据。" }, { "type": "uint32_t", "name": "w", "desc": "宽度。" }, { "type": "uint32_t", "name": "h", "desc": "高度。" } ], "annotation": { "static": true }, "desc": "dump mono bitmap。", "name": "bitmap_mono_dump", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "bitmap对象。" } ], "annotation": { "deconstructor": true, "scriptable": true, "gc": true }, "desc": "销毁图片。", "name": "bitmap_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "bitmap_format_t", "name": "format", "desc": "位图格式。" } ], "annotation": { "scriptable": true, "static": true }, "desc": "获取位图格式对应的颜色位数。", "name": "bitmap_get_bpp_of_format", "return": { "type": "uint32_t", "desc": "成功返回颜色位数，失败返回0。" } } ], "events": [], "properties": [ { "name": "w", "desc": "宽度。", "type": "wh_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "h", "desc": "高度。", "type": "wh_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "line_length", "desc": "每一行实际占用的内存(也称为stride或pitch)，一般情况下为w*bpp。", "type": "uint32_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "flags", "desc": "标志。请参考{bitmap_flag_t}。", "type": "uint16_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "format", "desc": "格式。请参考{bitmap_format_t}。", "type": "uint16_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "name", "desc": "名称。", "type": "const char*", "annotation": { "readable": true, "scriptable": true } }, { "name": "buffer", "desc": "图片数据。", "type": "graphic_buffer_t*", "annotation": { "readable": true } } ], "header": "base/bitmap.h", "desc": "位图。", "name": "bitmap_t", "order": -9, "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "bool_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为bool的值。", "name": "value_set_bool", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为bool的值。", "name": "value_bool", "return": { "type": "bool_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "int8_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为int8的值。", "name": "value_set_int8", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为int8的值。", "name": "value_int8", "return": { "type": "int8_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "uint8_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为uint8的值。", "name": "value_set_uint8", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为uint8的值。", "name": "value_uint8", "return": { "type": "int8_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "int16_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为int16的值。", "name": "value_set_int16", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为int16的值。", "name": "value_int16", "return": { "type": "int16_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "uint16_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为uint16的值。", "name": "value_set_uint16", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为uint16的值。", "name": "value_uint16", "return": { "type": "uint16_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "int32_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为int32的值。", "name": "value_set_int32", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为int32的值。", "name": "value_int32", "return": { "type": "int32_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "uint32_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为uint32的值。", "name": "value_set_uint32", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": {}, "desc": "获取类型为uint32的值。", "name": "value_uint32", "return": { "type": "uint32_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "int64_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为int64的值。", "name": "value_set_int64", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为int64的值。", "name": "value_int64", "return": { "type": "int64_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "uint64_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为uint64的值。", "name": "value_set_uint64", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为uint64的值。", "name": "value_uint64", "return": { "type": "uint64_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "void*", "name": "value", "desc": "待设置的值。" } ], "annotation": {}, "desc": "设置类型为pointer的值。", "name": "value_set_pointer", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": {}, "desc": "获取类型为pointer的值。", "name": "value_pointer", "return": { "type": "void*", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "float_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为float\\_t的值。", "name": "value_set_float", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": {}, "desc": "获取类型为float\\_t的值。", "name": "value_float", "return": { "type": "float_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "float", "name": "value", "desc": "待设置的值。" } ], "annotation": {}, "desc": "设置类型为float的值。", "name": "value_set_float32", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为float的值。", "name": "value_float32", "return": { "type": "float", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "double", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为double的值。", "name": "value_set_double", "alias": "value_set_float64", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为double的值。", "name": "value_double", "alias": "value_float64", "return": { "type": "double", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "const char*", "name": "value", "desc": "待设置的值。" } ], "annotation": {}, "desc": "设置类型为字符串的值。", "name": "value_set_str", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "const char*", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为字符串的值(并拷贝字符串)。\n\n> 供脚本语言使用。", "name": "value_dup_str", "alias": "value_set_str", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "const wchar_t*", "name": "value", "desc": "待设置的值。" } ], "annotation": {}, "desc": "设置类型为宽字符串的值。", "name": "value_set_wstr", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取类型为字符串的值。", "name": "value_str", "return": { "type": "const char*", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": {}, "desc": "获取类型为宽字符串的值。", "name": "value_wstr", "return": { "type": "const wchar_t*", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "value", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "判断value是否为空值。", "name": "value_is_null", "return": { "type": "bool_t", "desc": "为空值返回TRUE，否则返回FALSE。" } }, { "params": [ { "type": "value_t*", "name": "value", "desc": "value对象。" }, { "type": "value_t*", "name": "other", "desc": "value对象。" } ], "annotation": {}, "desc": "判断两个value是否相同。", "name": "value_equal", "return": { "type": "bool_t", "desc": "为空值返回TRUE，否则返回FALSE。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": {}, "desc": "转换为int的值。", "name": "value_int", "return": { "type": "int", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "int32_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为int的值。", "name": "value_set_int", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "object_t*", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为object的值。", "name": "value_set_object", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "转换为object的值。", "name": "value_object", "return": { "type": "object_t*", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "uint32_t", "name": "value", "desc": "待设置的值。" } ], "annotation": { "scriptable": true }, "desc": "设置类型为token的值。", "name": "value_set_token", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "scriptable": true }, "desc": "获取token的值。", "name": "value_token", "return": { "type": "uint32_t", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "char*", "name": "str", "desc": "待设置的值。" }, { "type": "uint32_t", "name": "size", "desc": "长度。" } ], "annotation": {}, "desc": "设置类型为带长度的字符串的值。", "name": "value_set_sized_str", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": {}, "desc": "获取为sized_str的值。", "name": "value_sized_str", "return": { "type": "sized_str_t*", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "void*", "name": "value", "desc": "待设置的值。" }, { "type": "uint32_t", "name": "size", "desc": "长度。" } ], "annotation": {}, "desc": "设置类型为binary_data的值。", "name": "value_set_binary_data", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": {}, "desc": "获取为binary_data的值。", "name": "value_binary_data", "return": { "type": "binary_data_t*", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" }, { "type": "void*", "name": "value", "desc": "待设置的值。" }, { "type": "uint32_t", "name": "size", "desc": "长度。" } ], "annotation": {}, "desc": "设置类型为ubjson的值。", "name": "value_set_ubjson", "return": { "type": "value_t*", "desc": "value对象本身。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": {}, "desc": "获取为ubjson的值。", "name": "value_ubjson", "return": { "type": "binary_data_t*", "desc": "值。" } }, { "params": [ { "type": "value_t*", "name": "dst", "desc": "目的value对象。" }, { "type": "value_t*", "name": "src", "desc": "源value对象。" } ], "annotation": {}, "desc": "拷贝value的值。", "name": "value_copy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "value_t*", "name": "dst", "desc": "目的value对象。" }, { "type": "value_t*", "name": "src", "desc": "源value对象。" } ], "annotation": {}, "desc": "深拷贝value的值。", "name": "value_deep_copy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "constructor": true, "scriptable": true, "gc": true }, "desc": "创建value对象。", "name": "value_create", "return": { "type": "value_t*", "desc": "对象。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "deconstructor": true, "scriptable": true, "gc": true }, "desc": "销毁value对象。", "name": "value_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "value_t*", "name": "v", "desc": "value对象。" } ], "annotation": { "deconstructor": true, "scriptable": true }, "desc": "重置value对象。", "name": "value_reset", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "value_t*", "name": "value", "desc": "value对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为value对象。\n\n> 供脚本语言使用", "name": "value_cast", "return": { "type": "value_t*", "desc": "对象。" } } ], "events": [], "properties": [], "header": "tkc/value.h", "desc": "一个通用数据类型，用来存放整数、浮点数、字符串和其它对象。\n\n在C/C++中，一般不需动态创建对象，直接声明并初始化即可。如：\n\n```c\nvalue_t v;\nvalue_set_int(&v, 100);\n```\n\n> 在脚本语言中，需要动态创建对象。", "name": "value_t", "order": -9, "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" } ], "annotation": { "deconstructor": true, "scriptable": true, "gc": true }, "desc": "引用计数减1。引用计数为0时，销毁对象。", "name": "object_unref", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" } ], "annotation": { "constructor": true, "scriptable": true, "gc": true }, "desc": "引用计数加1。", "name": "object_ref", "return": { "type": "object_t*", "desc": "返回object对象。" } }, { "params": [ { "type": "const object_vtable_t*", "name": "vt", "desc": "虚函数表。" } ], "annotation": {}, "desc": "创建对象。\n\n> 仅供子类调用。", "name": "object_create", "return": { "type": "ret_t", "desc": "返回object对象。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" } ], "annotation": { "scriptable": true }, "desc": "获取对象的类型名称。", "name": "object_get_type", "return": { "type": "const char*", "desc": "返回对象的类型名称。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" } ], "annotation": { "scriptable": true }, "desc": "获取对象的描述信息。", "name": "object_get_desc", "return": { "type": "const char*", "desc": "返回对象的描述信息。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" } ], "annotation": { "scriptable": true }, "desc": "获取对象占用内存的大小。", "name": "object_get_size", "return": { "type": "uint32_t", "desc": "返回对象占用内存的大小。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" } ], "annotation": { "scriptable": true }, "desc": "判断对象是否是集合。", "name": "object_is_collection", "return": { "type": "bool_t", "desc": "返回TRUE表示是集合，否则不是。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "对象的名称。" } ], "annotation": { "scriptable": true }, "desc": "设置对象的名称。", "name": "object_set_name", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "object_t*", "name": "other", "desc": "比较的object对象。" } ], "annotation": { "scriptable": true }, "desc": "比较两个对象。", "name": "object_compare", "return": { "type": "int", "desc": "返回比较结果。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "value_t*", "name": "v", "desc": "返回属性的值。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的值。", "name": "object_get_prop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的字符串类型的值。", "name": "object_get_prop_str", "return": { "type": "const char*", "desc": "返回指定属性的字符串类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的指针类型的值。", "name": "object_get_prop_pointer", "return": { "type": "void*", "desc": "返回指定属性的指针类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的object类型的值。", "name": "object_get_prop_object", "return": { "type": "object_t*", "desc": "返回指定属性的object类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "int32_t", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的整数类型的值。", "name": "object_get_prop_int", "return": { "type": "int32_t", "desc": "返回指定属性的整数类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "bool_t", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的bool类型的值。", "name": "object_get_prop_bool", "return": { "type": "bool_t", "desc": "返回指定属性的bool类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "float_t", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的浮点数类型的值。", "name": "object_get_prop_float", "return": { "type": "float_t", "desc": "返回指定属性的浮点数类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" } ], "annotation": { "scriptable": true }, "desc": "删除指定属性。", "name": "object_remove_prop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "value_t*", "name": "value", "desc": "属性的值。" } ], "annotation": { "scriptable": true }, "desc": "设置指定属性的值。", "name": "object_set_prop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "const char*", "name": "value", "desc": "属性的值。" } ], "annotation": { "scriptable": true }, "desc": "设置指定属性的字符串类型的值。", "name": "object_set_prop_str", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "void*", "name": "value", "desc": "属性的值。" } ], "annotation": {}, "desc": "设置指定属性的指针类型的值。", "name": "object_set_prop_pointer", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "object_t*", "name": "value", "desc": "属性的值。" } ], "annotation": { "scriptable": true }, "desc": "设置指定属性的object类型的值。", "name": "object_set_prop_object", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "int32_t", "name": "value", "desc": "属性的值。" } ], "annotation": { "scriptable": true }, "desc": "设置指定属性的整数类型的值。", "name": "object_set_prop_int", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "bool_t", "name": "value", "desc": "属性的值。" } ], "annotation": { "scriptable": true }, "desc": "设置指定属性的bool类型的值。", "name": "object_set_prop_bool", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "float_t", "name": "value", "desc": "属性的值。" } ], "annotation": { "scriptable": true }, "desc": "设置指定属性的浮点数类型的值。", "name": "object_set_prop_float", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "目标对象。" }, { "type": "object_t*", "name": "src", "desc": "源对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" } ], "annotation": { "scriptable": true }, "desc": "拷贝指定的属性。", "name": "object_copy_prop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "tk_visit_t", "name": "on_prop", "desc": "回调函数。" }, { "type": "void*", "name": "ctx", "desc": "回调函数上下文。" } ], "annotation": {}, "desc": "遍历所有属性。", "name": "object_foreach_prop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" } ], "annotation": { "scriptable": true }, "desc": "检查是否存在指定的属性。", "name": "object_has_prop", "return": { "type": "bool_t", "desc": "返回TRUE表示存在，否则表示不存在。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "expr", "desc": "表达式。" }, { "type": "value_t*", "name": "v", "desc": "返回计算结果。" } ], "annotation": { "scriptable": true }, "desc": "计算一个表达式，表达式中引用的变量从prop中获取。", "name": "object_eval", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "命令的名称。" }, { "type": "const char*", "name": "args", "desc": "命令的参数。" } ], "annotation": { "scriptable": true }, "desc": "检查是否可以执行指定的命令。", "name": "object_can_exec", "return": { "type": "bool_t", "desc": "返回TRUE表示可以执行，否则表示不可以执行。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "name", "desc": "命令的名称。" }, { "type": "const char*", "name": "args", "desc": "命令的参数。" } ], "annotation": { "scriptable": true }, "desc": "执行指定的命令。", "name": "object_exec", "alias": "execute", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" } ], "annotation": { "scriptable": true }, "desc": "触发EVT_PROPS_CHANGED事件。", "name": "object_notify_changed", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "path", "desc": "属性的path，各级之间用.分隔。" }, { "type": "value_t*", "name": "v", "desc": "返回属性的值。" } ], "annotation": {}, "desc": "获取指定path属性的值。", "name": "object_get_prop_by_path", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "path", "desc": "属性的path。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的字符串类型的值。", "name": "object_get_prop_str_by_path", "return": { "type": "const char*", "desc": "返回指定属性的字符串类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "path", "desc": "属性的path。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的指针类型的值。", "name": "object_get_prop_pointer_by_path", "return": { "type": "void*", "desc": "返回指定属性的指针类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "path", "desc": "属性的path。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的object类型的值。", "name": "object_get_prop_object_by_path", "return": { "type": "object_t*", "desc": "返回指定属性的object类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "path", "desc": "属性的path。" }, { "type": "int32_t", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的整数类型的值。", "name": "object_get_prop_int_by_path", "return": { "type": "int32_t", "desc": "返回指定属性的整数类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "path", "desc": "属性的path。" }, { "type": "bool_t", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的bool类型的值。", "name": "object_get_prop_bool_by_path", "return": { "type": "bool_t", "desc": "返回指定属性的bool类型的值。" } }, { "params": [ { "type": "object_t*", "name": "obj", "desc": "object对象。" }, { "type": "const char*", "name": "path", "desc": "属性的path。" }, { "type": "float_t", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取指定属性的浮点数类型的值。", "name": "object_get_prop_float_by_path", "return": { "type": "float_t", "desc": "返回指定属性的浮点数类型的值。" } } ], "events": [], "properties": [ { "name": "ref_count", "desc": "引用计数。", "type": "int32_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "name", "desc": "对象的名称。", "type": "char*", "annotation": { "readable": true, "scriptable": true } } ], "header": "tkc/object.h", "desc": "对象接口。", "name": "object_t", "order": -9, "parent": "emitter_t", "annotation": { "scriptable": true }, "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "wh_t", "name": "w", "desc": "LCD宽度。" }, { "type": "wh_t", "name": "h", "desc": "LCD高度。" }, { "type": "app_type_t", "name": "app_type", "desc": "应用程序的类型。" }, { "type": "const char*", "name": "app_name", "desc": "应用程序的名称(必须为常量字符串)。" }, { "type": "const char*", "name": "app_root", "desc": "应用程序的根目录，用于定位资源文件(必须为常量字符串)。" } ], "annotation": { "static": true, "scriptable": true }, "desc": "初始化TK。", "name": "tk_init", "alias": "init", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "static": true, "scriptable": true }, "desc": "进入TK事件主循环。", "name": "tk_run", "alias": "run", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "static": true, "scriptable": true }, "desc": "退出TK事件主循环。", "name": "tk_quit", "alias": "global_quit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "static": true, "scriptable": true }, "desc": "获取全局指针的X坐标。", "name": "tk_get_pointer_x", "alias": "global_get_pointer_x", "return": { "type": "int32_t", "desc": "返回全局指针的X坐标。" } }, { "params": [], "annotation": { "static": true, "scriptable": true }, "desc": "获取全局指针的Y坐标。", "name": "tk_get_pointer_y", "alias": "global_get_pointer_y", "return": { "type": "int32_t", "desc": "返回全局指针的X坐标。" } }, { "params": [], "annotation": { "static": true, "scriptable": true }, "desc": "获取全局指针是否按下。", "name": "tk_is_pointer_pressed", "alias": "global_is_pointer_pressed", "return": { "type": "bool_t", "desc": "返回全局指针是否按下。" } }, { "params": [ { "type": "int", "name": "orientation", "desc": "旋转方向。" } ], "annotation": {}, "desc": "设置屏幕的旋转方向(XXX:目前仅支持0度和90度)。", "name": "tk_set_lcd_orientation", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": {}, "desc": "初始化资源。", "name": "tk_init_assets", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": {}, "desc": "init。\n> public for test program", "name": "tk_init_internal", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": {}, "desc": "deinit。\n> public for test program", "name": "tk_deinit_internal", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": {}, "desc": "public for web", "name": "tk_exit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": {}, "desc": "创建缺省的资源加载器。", "name": "asset_loader_default_create", "return": { "type": "asset_loader_t*", "desc": "返回loader对象。" } }, { "params": [ { "type": "const char*", "name": "zipfile", "desc": "zip文件名。" } ], "annotation": {}, "desc": "创建zip资源加载器。", "name": "asset_loader_zip_create", "return": { "type": "asset_loader_t*", "desc": "返回loader对象。" } }, { "params": [ { "type": "data_reader_t*", "name": "reader", "desc": "reader对象。" }, { "type": "bool_t", "name": "own_the_reader", "desc": "如果希望销毁loader时销毁reader，请设置为TRUE。" } ], "annotation": {}, "desc": "创建zip资源加载器。", "name": "asset_loader_zip_create_with_reader", "return": { "type": "asset_loader_t*", "desc": "返回loader对象。" } } ], "events": [], "properties": [], "header": "src/awtk_global.h", "desc": "TK全局对象。", "name": "global_t", "annotation": { "scriptable": true, "fake": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true }, "desc": "获取缺省的子控件布局算法工厂对象。", "name": "children_layouter_factory", "return": { "type": "children_layouter_factory_t*", "desc": "返回子控件布局算法工厂对象。" } }, { "params": [ { "type": "children_layouter_factory_t*", "name": "factory", "desc": "子控件布局算法工厂对象。" } ], "annotation": {}, "desc": "设置缺省的子控件布局算法工厂对象。", "name": "children_layouter_factory_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "constructor": true }, "desc": "创建子控件布局算法工厂对象。", "name": "children_layouter_factory_create", "return": { "type": "children_layouter_factory_t*", "desc": "返回子控件布局算法工厂对象。" } }, { "params": [ { "type": "children_layouter_factory_t*", "name": "factory", "desc": "layouter工厂对象。" }, { "type": "const char*", "name": "type", "desc": "子控件布局算法类型。" }, { "type": "children_layouter_create_t", "name": "create", "desc": "子控件布局算法创建函数。" } ], "annotation": {}, "desc": "注册子控件布局算法创建函数。", "name": "children_layouter_factory_register", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "children_layouter_factory_t*", "name": "factory", "desc": "子控件布局算法工厂对象。" }, { "type": "const char*", "name": "type", "desc": "类型。" } ], "annotation": { "constructor": true }, "desc": "创建指定类型的子控件布局算法对象。", "name": "children_layouter_factory_create_layouter", "return": { "type": "children_layouter_t*", "desc": "返回子控件布局算法对象。" } }, { "params": [ { "type": "children_layouter_factory_t*", "name": "factory", "desc": "子控件布局算法工厂对象。" } ], "annotation": {}, "desc": "析构并释放子控件布局算法工厂对象。", "name": "children_layouter_factory_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/children_layouter_factory.h", "desc": "子控件布局算法工厂。", "name": "children_layouter_factory_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "children_layouter_t*", "name": "layouter", "desc": "layouter对象。" } ], "annotation": {}, "desc": "获取全部参数。", "name": "children_layouter_to_string", "return": { "type": "ret_t", "desc": "返回字符串格式的参数。" } }, { "params": [ { "type": "children_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "widget_t*", "name": "widget", "desc": "控件。" } ], "annotation": {}, "desc": "对控件的子控件进行布局。", "name": "children_layouter_layout", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "children_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "const char*", "name": "name", "desc": "参数名。" }, { "type": "value_t*", "name": "v", "desc": "返回参数的值。" } ], "annotation": {}, "desc": "获取指定的参数。", "name": "children_layouter_get_param", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "children_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "const char*", "name": "name", "desc": "参数名。" }, { "type": "const value_t*", "name": "v", "desc": "参数的值。" } ], "annotation": {}, "desc": "获取指定的参数。", "name": "children_layouter_set_param", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "children_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "const char*", "name": "name", "desc": "参数名。" }, { "type": "const char*", "name": "value", "desc": "参数值。" } ], "annotation": {}, "desc": "设置字符串格式的参数。", "name": "children_layouter_set_param_str", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "children_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "const char*", "name": "name", "desc": "参数名。" }, { "type": "float_t", "name": "defval", "desc": "缺省值。" } ], "annotation": {}, "desc": "获取指定的浮点格式的参数。", "name": "children_layouter_get_param_float", "return": { "type": "ret_t", "desc": "成功返回参数的值，失败返回缺省值。" } }, { "params": [ { "type": "children_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "const char*", "name": "name", "desc": "参数名。" }, { "type": "int32_t", "name": "defval", "desc": "缺省值。" } ], "annotation": {}, "desc": "获取指定的整数格式的参数。", "name": "children_layouter_get_param_int", "return": { "type": "ret_t", "desc": "成功返回参数的值，失败返回缺省值。" } }, { "params": [ { "type": "children_layouter_t*", "name": "layouter", "desc": "layouter对象。" } ], "annotation": {}, "desc": "判断layouter对象是否有效。", "name": "children_layouter_is_valid", "return": { "type": "bool_t", "desc": "返回TRUE表示有效，否则表示无效。" } }, { "params": [ { "type": "children_layouter_t*", "name": "layouter", "desc": "layouter对象。" } ], "annotation": {}, "desc": "销毁layouter对象。", "name": "children_layouter_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "const char*", "name": "params", "desc": "参数。" } ], "annotation": {}, "desc": "创建layouter对象。", "name": "children_layouter_create", "return": { "type": "children_layouter_t*", "desc": "返回layouter对象。" } }, { "params": [ { "type": "children_layouter_t*", "name": "layouter", "desc": "被克隆的对象。" } ], "annotation": {}, "desc": "克隆layouter对象。", "name": "children_layouter_clone", "return": { "type": "children_layouter_t*", "desc": "返回layouter对象。" } } ], "events": [], "properties": [], "header": "base/children_layouter.h", "desc": "子控件排版布局器的接口。\n\n按特定算法对子控件进行排版布局，子类需要实现vtable中的函数。", "name": "children_layouter_t", "level": 1 }, { "type": "enum", "desc": "剪切板数据类型定义。", "consts": [ { "desc": "无数据。", "name": "CLIP_BOARD_DATA_TYPE_NONE" }, { "desc": "UTF8文本。", "name": "CLIP_BOARD_DATA_TYPE_TEXT" } ], "header": "base/clip_board.h", "name": "clip_board_data_type_t", "prefix": "CLIP_BOARD_DATA_TYPE_", "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true }, "desc": "获取缺省的剪切板对象。", "name": "clip_board", "alias": "clip_board_instance", "return": { "type": "ret_t", "desc": "返回缺省剪切板对象。" } }, { "params": [ { "type": "clip_board_t*", "name": "cl", "desc": "剪切板对象。" } ], "annotation": {}, "desc": "设置缺省的剪切板对象。", "name": "clip_board_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "clip_board_t*", "name": "cl", "desc": "剪切板对象。" } ], "annotation": {}, "desc": "清空剪切板中的数据。", "name": "clip_board_clear", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "clip_board_t*", "name": "cl", "desc": "剪切板对象。" }, { "type": "clip_board_data_type_t", "name": "type", "desc": "数据类型。" }, { "type": "const void* data", "name": "data", "desc": "数据。" }, { "type": "uint32_t", "name": "size", "desc": "数据长度" } ], "annotation": {}, "desc": "设置数据到剪切板中。", "name": "clip_board_set_data", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "clip_board_t*", "name": "cl", "desc": "剪切板对象。" }, { "type": "clip_board_data_type_t*", "name": "type", "desc": "返回数据类型(可为NULL)。" }, { "type": "void** data", "name": "data", "desc": "返回数据(可为NULL)。" }, { "type": "uint32_t*", "name": "size", "desc": "返回数据长度(可为NULL)。" } ], "annotation": {}, "desc": "从剪切板中获取数据。", "name": "clip_board_get_data", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "clip_board_t*", "name": "cl", "desc": "剪切板对象。" } ], "annotation": {}, "desc": "销毁剪切板对象。", "name": "clip_board_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "const char*", "name": "text", "desc": "文本。" } ], "annotation": { "static": true, "scriptable": true }, "desc": "设置文本(UTF8)数据到剪切板。", "name": "clip_board_set_text", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "static": true, "scriptable": true }, "desc": "从剪切板中获取文本(UTF8)数据。", "name": "clip_board_get_text", "return": { "type": "const char*", "desc": "返回文本数据。" } }, { "params": [ { "type": "const char*", "name": "assetname", "desc": "资源的名称。" } ], "annotation": {}, "desc": "创建基于asset的data reader。", "name": "data_reader_asset_create", "return": { "type": "data_reader_t*", "desc": "返回data reader对象。" } } ], "events": [], "properties": [], "header": "base/clip_board.h", "desc": "剪切板接口。", "name": "clip_board_t", "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true }, "desc": "获取缺省的对话框高亮策略工厂对象。", "name": "dialog_highlighter_factory", "return": { "type": "dialog_highlighter_factory_t*", "desc": "返回对话框高亮策略工厂对象。" } }, { "params": [ { "type": "dialog_highlighter_factory_t*", "name": "factory", "desc": "对话框高亮策略工厂对象。" } ], "annotation": {}, "desc": "设置缺省的对话框高亮策略工厂对象。", "name": "dialog_highlighter_factory_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "constructor": true }, "desc": "创建对话框高亮策略工厂对象。", "name": "dialog_highlighter_factory_create", "return": { "type": "dialog_highlighter_factory_t*", "desc": "返回对话框高亮策略工厂对象。" } }, { "params": [ { "type": "dialog_highlighter_factory_t*", "name": "factory", "desc": "highlighter工厂对象。" }, { "type": "const char*", "name": "type", "desc": "对话框高亮策略类型。" }, { "type": "dialog_highlighter_create_t", "name": "create", "desc": "对话框高亮策略创建函数。" } ], "annotation": {}, "desc": "注册对话框高亮策略创建函数。", "name": "dialog_highlighter_factory_register", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "dialog_highlighter_factory_t*", "name": "factory", "desc": "对话框高亮策略工厂对象。" }, { "type": "const char*", "name": "args", "desc": "参数。如default(alpha=90)" }, { "type": "widget_t*", "name": "dialog", "desc": "对话框对象。" } ], "annotation": { "constructor": true }, "desc": "创建指定类型的对话框高亮策略对象。", "name": "dialog_highlighter_factory_create_highlighter", "return": { "type": "dialog_highlighter_t*", "desc": "返回窗口动画对象。" } }, { "params": [ { "type": "dialog_highlighter_factory_t*", "name": "factory", "desc": "对话框高亮策略工厂对象。" } ], "annotation": {}, "desc": "析构并释放对话框高亮策略工厂对象。", "name": "dialog_highlighter_factory_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/dialog_highlighter_factory.h", "desc": "对话框高亮策略工厂。", "name": "dialog_highlighter_factory_t", "level": 1 }, { "type": "enum", "desc": "@type string\n内置的对话框高亮策略。", "consts": [ { "desc": "缺省的对话框高亮策略。", "name": "DIALOG_HIGHLIGHTER_DEFAULT" } ], "header": "base/dialog_highlighter.h", "name": "dialog_highlighter_type_t", "prefix": "DIALOG_HIGHLIGHTER_", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "const dialog_highlighter_vtable_t*", "name": "vt", "desc": "虚表对象。" } ], "annotation": {}, "desc": "创建对话框高亮策略对象。\n\n>供子类构造函数用。", "name": "dialog_highlighter_create", "return": { "type": "dialog_highlighter_t*", "desc": "返回对话框高亮策略对象" } }, { "params": [ { "type": "dialog_highlighter_t*", "name": "h", "desc": "对话框高亮策略对象。" }, { "type": "bitmap_t*", "name": "img", "desc": "背景截图。" }, { "type": "framebuffer_object_t*", "name": "fbo", "desc": "fbo对象。" } ], "annotation": {}, "desc": "设置背景图片。", "name": "dialog_highlighter_set_bg", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "dialog_highlighter_t*", "name": "h", "desc": "对话框高亮策略对象。" }, { "type": "rect_t*", "name": "clip_rect", "desc": "背景显示裁减区。" } ], "annotation": {}, "desc": "设置背景图片的显示裁减区。", "name": "dialog_highlighter_set_bg_clip_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "dialog_highlighter_t*", "name": "h", "desc": "对话框高亮策略对象。" }, { "type": "canvas_t*", "name": "c", "desc": "画布。" } ], "annotation": {}, "desc": "初始化。在绘制完背景，在截图前调用。", "name": "dialog_highlighter_prepare", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "dialog_highlighter_t*", "name": "h", "desc": "对话框高亮策略对象。" }, { "type": "float_t", "name": "percent", "desc": "动画进度(0-1)，1表示打开已经完成。" } ], "annotation": {}, "desc": "绘制背景。", "name": "dialog_highlighter_draw", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "dialog_highlighter_t*", "name": "h", "desc": "对话框高亮策略对象。" } ], "annotation": {}, "desc": "是否是动态绘制(方便外层优化)。", "name": "dialog_highlighter_is_dynamic", "return": { "type": "bool_t", "desc": "返回TRUE表示动态绘制，否则表示不是动态绘制。" } }, { "params": [ { "type": "dialog_highlighter_t*", "name": "h", "desc": "对话框高亮策略对象。" } ], "annotation": {}, "desc": "销毁对话框高亮策略对象。", "name": "dialog_highlighter_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "img", "desc": "底层窗口的截图。", "type": "bitmap_t" }, { "name": "canvas", "desc": "画布。", "type": "canvas_t*" }, { "name": "dialog", "desc": "对应的对话框。", "type": "widget_t*" }, { "name": "clip_rect", "desc": "截图的显示裁减区", "type": "rect_t*" } ], "header": "base/dialog_highlighter.h", "desc": "对话框高亮策略。\n\n> 高亮策略的基本思路是对背景进行处理，比如将背景变暗或变模糊。", "name": "dialog_highlighter_t", "level": 1 }, { "type": "enum", "desc": "对话框退出码。\n\n> 一般用作dialog_quit函数的参数。", "consts": [ { "desc": "对话框被强行关闭或不关心关闭原因。", "name": "DIALOG_QUIT_NONE" }, { "desc": "点击“OK”按钮关闭。", "name": "DIALOG_QUIT_OK" }, { "desc": "点击“YES”按钮关闭。", "name": "DIALOG_QUIT_YES" }, { "desc": "点击“CANCEL”按钮关闭。", "name": "DIALOG_QUIT_CANCEL" }, { "desc": "点击“NO”按钮关闭。", "name": "DIALOG_QUIT_NO" }, { "desc": "点击其它按钮关闭。", "name": "DIALOG_QUIT_OTHER" } ], "header": "base/dialog.h", "name": "dialog_quit_code_t", "prefix": "DIALOG_QUIT_", "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "const char**", "name": "attrs", "desc": "属性列表。" }, { "type": "const char*", "name": "attr", "desc": "属性名。" } ], "annotation": {}, "desc": "获取属性。", "name": "xml_builder_get_attr", "return": { "type": "const char*", "desc": "返回属性的值。" } } ], "events": [], "properties": [], "header": "xml/xml_builder.h", "desc": "xml builder interface", "name": "xml_builder_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "uint32_t", "name": "value", "desc": "资源的类型。" } ], "annotation": {}, "desc": "获取资源类型枚值和名称的对应关系。", "name": "asset_type_find_by_value", "return": { "type": "const key_type_value_t*", "desc": "返回资源类型枚值和名称的对应关系。" } }, { "params": [ { "type": "const key_type_value_t*", "name": "items", "desc": "特定枚举值对应列表。" }, { "type": "uint32_t", "name": "nr", "desc": "列表长度。" }, { "type": "const char*", "name": "name", "desc": "名称。" } ], "annotation": {}, "desc": "获取特定枚值和名称的对应关系。", "name": "find_item", "return": { "type": "const key_type_value_t*", "desc": "返回资源类型枚值和名称的对应关系。" } }, { "params": [ { "type": "const key_type_value_t*", "name": "items", "desc": "特定枚举值对应列表。" }, { "type": "uint32_t", "name": "nr", "desc": "列表长度。" }, { "type": "uint32_t", "name": "value", "desc": "资源的类型。" } ], "annotation": {}, "desc": "获取特定枚值和名称的对应关系。", "name": "find_item_by_value", "return": { "type": "const key_type_value_t*", "desc": "返回资源类型枚值和名称的对应关系。" } }, { "params": [ { "type": "const char*", "name": "name", "desc": "按键名。" } ], "annotation": {}, "desc": "获取按键值和名称的对应关系。", "name": "keys_type_find", "return": { "type": "const key_type_value_t*", "desc": "返回按键值和名称的对应关系。" } }, { "params": [ { "type": "uint32_t", "name": "value", "desc": "按键值。" } ], "annotation": {}, "desc": "获取按键值和名称的对应关系。", "name": "keys_type_find_by_value", "return": { "type": "const key_type_value_t*", "desc": "返回按键值和名称的对应关系。" } } ], "events": [], "properties": [], "header": "base/enums.h", "desc": "", "name": "enum_helper", "annotation": { "fake": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "const char*", "name": "filename", "desc": "用于保存事件的文件名。" } ], "annotation": { "static": true }, "desc": "开始事件记录。", "name": "event_recorder_player_start_record", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "const char*", "name": "filename", "desc": "存放事件的文件名。" }, { "type": "uint32_t", "name": "times", "desc": "循环播放的次数。" } ], "annotation": { "static": true }, "desc": "开始事件重放。", "name": "event_recorder_player_start_play", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "static": true }, "desc": "停止事件记录。", "name": "event_recorder_player_stop_record", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "static": true }, "desc": "停止事件重放。", "name": "event_recorder_player_stop_play", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/event_recorder_player.h", "desc": "事件录制与重放，用于辅助自动测试和压力测试。", "name": "event_recorder_player_t", "annotation": { "fake": true }, "level": 1 }, { "type": "enum", "desc": "类型常量定义。", "consts": [ { "desc": "指针按下事件名(pointer_event_t)。", "name": "EVT_POINTER_DOWN" }, { "desc": "指针按下事件名，在子控件处理之前触发(pointer_event_t)。", "name": "EVT_POINTER_DOWN_BEFORE_CHILDREN" }, { "desc": "指针移动事件名(pointer_event_t)。", "name": "EVT_POINTER_MOVE" }, { "desc": "指针移动事件名，在子控件处理之前触发(pointer_event_t)。", "name": "EVT_POINTER_MOVE_BEFORE_CHILDREN" }, { "desc": "指针抬起事件名(pointer_event_t)。", "name": "EVT_POINTER_UP" }, { "desc": "指针抬起事件名，在子控件处理之前触发(pointer_event_t)。", "name": "EVT_POINTER_UP_BEFORE_CHILDREN" }, { "desc": "滚轮事件名(wheel_event_t)。", "name": "EVT_WHEEL" }, { "desc": "鼠标滚轮事件名，在子控件处理之前触发(wheel_event_t)。", "name": "EVT_WHEEL_BEFORE_CHILDREN" }, { "desc": "取消前一个指针按下事件名(pointer_event_t)。", "name": "EVT_POINTER_DOWN_ABORT" }, { "desc": "右键/长按弹出上下文菜单的事件名(pointer_event_t)。", "name": "EVT_CONTEXT_MENU" }, { "desc": "指针进入事件名(pointer_event_t)。", "name": "EVT_POINTER_ENTER" }, { "desc": "指针离开事件名(pointer_event_t)。", "name": "EVT_POINTER_LEAVE" }, { "desc": "长按事件名(pointer_event_t)。", "name": "EVT_LONG_PRESS" }, { "desc": "点击事件名(pointer_event_t)。", "name": "EVT_CLICK" }, { "desc": "得到焦点事件名(event_t)。", "name": "EVT_FOCUS" }, { "desc": "失去焦点事件名(event_t)。", "name": "EVT_BLUR" }, { "desc": "键按下事件名(key_event_t)。", "name": "EVT_KEY_DOWN" }, { "desc": "键按下事件名，在子控件处理之前触发(key_event_t)。", "name": "EVT_KEY_DOWN_BEFORE_CHILDREN" }, { "desc": "按键repeat事件名(key_event_t)。", "name": "EVT_KEY_REPEAT" }, { "desc": "键抬起事件名(key_event_t)。", "name": "EVT_KEY_UP" }, { "desc": "键抬起事件名，在子控件处理之前触发(key_event_t)。", "name": "EVT_KEY_UP_BEFORE_CHILDREN" }, { "desc": "即将移动Widget的事件名(event_t)。", "name": "EVT_WILL_MOVE" }, { "desc": "移动Widget的事件名(event_t)。", "name": "EVT_MOVE" }, { "desc": "即将调整Widget大小的事件名(event_t)。", "name": "EVT_WILL_RESIZE" }, { "desc": "调整Widget大小的事件名(event_t)。", "name": "EVT_RESIZE" }, { "desc": "即将调整Widget大小/位置的事件名(event_t)。", "name": "EVT_WILL_MOVE_RESIZE" }, { "desc": "调整Widget大小/位置的事件名(event_t)。", "name": "EVT_MOVE_RESIZE" }, { "desc": "控件的值即将改变的事件名(event_t)。", "name": "EVT_VALUE_WILL_CHANGE" }, { "desc": "控件的值改变的事件名(event_t)。", "name": "EVT_VALUE_CHANGED" }, { "desc": "控件的值持续改变(如编辑器正在编辑)的事件名(event_t)。", "name": "EVT_VALUE_CHANGING" }, { "desc": "绘制的事件名(paint_event_t)。", "name": "EVT_PAINT" }, { "desc": "即将绘制的事件名(paint_event_t)。", "name": "EVT_BEFORE_PAINT" }, { "desc": "绘制完成的事件名(paint_event_t)。", "name": "EVT_AFTER_PAINT" }, { "desc": "绘制完成(canvas状态已经恢复)的事件名(paint_event_t)。", "name": "EVT_PAINT_DONE" }, { "desc": "locale改变的事件(event_t)。", "name": "EVT_LOCALE_CHANGED" }, { "desc": "控件动画开始事件(event_t)。", "name": "EVT_ANIM_START" }, { "desc": "控件动画被主动停止的事件(event_t)。", "name": "EVT_ANIM_STOP" }, { "desc": "控件动画被暂停的事件(event_t)。", "name": "EVT_ANIM_PAUSE" }, { "desc": "控件动画yoyo/repeat时，完成一次的事件(event_t)。", "name": "EVT_ANIM_ONCE" }, { "desc": "控件动画完成事件(event_t)。", "name": "EVT_ANIM_END" }, { "desc": "窗口加载完成事件(event_t)。", "name": "EVT_WINDOW_LOAD" }, { "desc": "控件加载完成事件(event_t)。", "name": "EVT_WIDGET_LOAD" }, { "desc": "窗口即将打开事件(event_t)。\n如果有窗口动画，在窗口动画开始前触发。如果没有窗口动画，在窗口被加载后的下一次循环中触发。", "name": "EVT_WINDOW_WILL_OPEN" }, { "desc": "窗口打开事件(event_t)。\n如果有窗口动画，在窗口动画完成时触发。如果没有窗口动画，在窗口被加载后的下一次循环中触发。", "name": "EVT_WINDOW_OPEN" }, { "desc": "窗口被切换到后台事件(event_t)。\n打开新窗口时，当前窗口被切换到后台时，对当前窗口触发本事件。", "name": "EVT_WINDOW_TO_BACKGROUND" }, { "desc": "窗口被切换到前台事件(event_t)。\n关闭当前窗口时，前一个窗口被切换到前台时，对前一个窗口触发本事件。", "name": "EVT_WINDOW_TO_FOREGROUND" }, { "desc": "窗口关闭事件。", "name": "EVT_WINDOW_CLOSE" }, { "desc": "请求关闭窗口的事件(event_t)。", "name": "EVT_REQUEST_CLOSE_WINDOW" }, { "desc": "顶层窗口改变的事件(window_event_t)。", "name": "EVT_TOP_WINDOW_CHANGED" }, { "desc": "输入法提交输入的文本事件(im_commit_event_t)。", "name": "EVT_IM_COMMIT" }, { "desc": "进入预编辑状态(event_t)。", "name": "EVT_IM_PREEDIT" }, { "desc": "确认预编辑内容，退出预编辑状态(event_t)。", "name": "EVT_IM_PREEDIT_CONFIRM" }, { "desc": "删除预编辑内容，退出预编辑状态event_t)。", "name": "EVT_IM_PREEDIT_ABORT" }, { "desc": "输入法请求显示候选字事件(im_candidates_event_t)。", "name": "EVT_IM_SHOW_CANDIDATES" }, { "desc": "输入法请求显示预候选字事件(im_candidates_event_t)。", "name": "EVT_IM_SHOW_PRE_CANDIDATES" }, { "desc": "输入法语言改变事件(event_t)。", "name": "EVT_IM_LANG_CHANGED" }, { "desc": "软键盘Action点击事件(event_t)。", "name": "EVT_IM_ACTION" }, { "desc": "请求更新软键盘上的Action按钮的信息(im_action_button_info_event_t)。", "name": "EVT_IM_ACTION_INFO" }, { "desc": "开始拖动(event_t)。", "name": "EVT_DRAG_START" }, { "desc": "拖动(event_t)。", "name": "EVT_DRAG" }, { "desc": "结束拖动(event_t)。", "name": "EVT_DRAG_END" }, { "desc": "Reset(event_t)。", "name": "EVT_RESET" }, { "desc": "在指定的时间内(WITH_SCREEN_SAVER_TIME)，没有用户输入事件，由窗口管理器触发。", "name": "EVT_SCREEN_SAVER" }, { "desc": "内存不足(event_t)。", "name": "EVT_LOW_MEMORY" }, { "desc": "内存耗尽(event_t)。", "name": "EVT_OUT_OF_MEMORY" }, { "desc": "屏幕即将旋转(event_t)。", "name": "EVT_ORIENTATION_WILL_CHANGED" }, { "desc": "屏幕旋转(event_t)。", "name": "EVT_ORIENTATION_CHANGED" }, { "desc": "控件创建事件(event_t)。", "name": "EVT_WIDGET_CREATED" }, { "desc": "请求退出应用程序事件。\n点击原生窗口关闭按钮时，通过窗口管理器触发，注册该事件并返回RET_STOP，可以阻止窗口关闭。", "name": "EVT_REQUEST_QUIT_APP" }, { "desc": "主题变化(event_t)。", "name": "EVT_THEME_CHANGED" }, { "desc": "控件加载新的子控件(event_t)。", "name": "EVT_WIDGET_ADD_CHILD" }, { "desc": "控件移除子控件(event_t)。", "name": "EVT_WIDGET_REMOVE_CHILD" }, { "desc": "scroll view开始滚动(event_t)。", "name": "EVT_SCROLL_START" }, { "desc": "scroll view滚动(event_t)。", "name": "EVT_SCROLL" }, { "desc": "scroll view结束滚动(event_t)。", "name": "EVT_SCROLL_END" }, { "desc": "event queue其它请求编号起始值。", "name": "EVT_REQ_START" }, { "desc": "用户定义事件起始值。", "name": "EVT_USER_START" }, { "desc": "无效事件名称。", "name": "EVT_NONE" }, { "desc": "对象的属性即将改变的事件名(prop_change_event_t)。", "name": "EVT_PROP_WILL_CHANGE" }, { "desc": "对象的属性改变的事件名(prop_change_event_t)。", "name": "EVT_PROP_CHANGED" }, { "desc": "对象即将执行命令(cmd_exec_event_t)。", "name": "EVT_CMD_WILL_EXEC" }, { "desc": "对象完成执行命令(cmd_exec_event_t)。", "name": "EVT_CMD_EXECED" }, { "desc": "对象命令是否能执行指定的命令(cmd_exec_event_t)。", "name": "EVT_CMD_CAN_EXEC" }, { "desc": "即将增加和删除集合中的项目(event_t)。", "name": "EVT_ITEMS_WILL_CHANGE" }, { "desc": "完成增加和删除集合中的项目(event_t)。", "name": "EVT_ITEMS_CHANGED" }, { "desc": "对象的属性改变的事件名(props_event_t)。", "name": "EVT_PROPS_CHANGED" }, { "desc": "进度状态(progress_event_t)。", "name": "EVT_PROGRESS" }, { "desc": "完成(done_event_t)。", "name": "EVT_DONE" }, { "desc": "错误(error_event_t)。", "name": "EVT_ERROR" }, { "desc": "对象销毁事件名(event_t)。", "name": "EVT_DESTROY" } ], "header": "base/events.h", "name": "event_type_t", "prefix": "EVT_", "annotation": { "scriptable": true }, "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "初始化AWTK控件。", "name": "tk_widgets_init", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" }, "type": "method", "header": "widgets/widgets.h", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint32_t", "name": "duration", "desc": "动画持续时间。" }, { "type": "uint32_t", "name": "delay", "desc": "动画执行时间。" }, { "type": "easing_type_t", "name": "easing", "desc": "插值函数类型。" } ], "annotation": {}, "desc": "创建动画对象。", "name": "widget_animator_scroll_create", "return": { "type": "widget_animator_t*", "desc": "成功返回动画对象，失败返回NULL。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象本身。" }, { "type": "xy_t", "name": "x_from", "desc": "x起点值。" }, { "type": "xy_t", "name": "y_from", "desc": "y起点值。" }, { "type": "xy_t", "name": "x_to", "desc": "x终点值。" }, { "type": "xy_t", "name": "y_to", "desc": "y终点值。" } ], "annotation": {}, "desc": "设置动画对象的参数。", "name": "widget_animator_scroll_set_params", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "widget_animators/widget_animator_scroll.h", "desc": "滚动控件的动画。\n本动画也可以用widget_animator_prop2实现，但滚动控件需要访问内部数据结构，出于可读性考虑保留独立实现。", "name": "widget_animator_scroll_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint32_t", "name": "duration", "desc": "动画持续时间。" }, { "type": "uint32_t", "name": "delay", "desc": "动画执行时间。" }, { "type": "easing_type_t", "name": "easing", "desc": "插值函数类型。" }, { "type": "const char*", "name": "prop1_name", "desc": "属性1的名称。" }, { "type": "const char*", "name": "prop2_name", "desc": "属性2的名称。" } ], "annotation": {}, "desc": "创建双属性动画对象。", "name": "widget_animator_prop2_create", "return": { "type": "widget_animator_t*", "desc": "成功返回动画对象，失败返回NULL。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象本身。" }, { "type": "double", "name": "from1", "desc": "x的初值。" }, { "type": "double", "name": "from2", "desc": "y的初值。" }, { "type": "double", "name": "to1", "desc": "x的终值。" }, { "type": "double", "name": "to2", "desc": "y的终值。" } ], "annotation": {}, "desc": "设置动画对象的参数。", "name": "widget_animator_prop2_set_params", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "widget_animators/widget_animator_prop2.h", "desc": "通过修改对象的两个指定属性形成动画效果。", "name": "widget_animator_prop2_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint32_t", "name": "duration", "desc": "动画持续时间。" }, { "type": "uint32_t", "name": "delay", "desc": "动画执行时间。" }, { "type": "easing_type_t", "name": "easing", "desc": "插值函数类型。" }, { "type": "const char*", "name": "prop_name", "desc": "属性的名称。" } ], "annotation": {}, "desc": "创建单属性动画对象。", "name": "widget_animator_prop_create", "return": { "type": "widget_animator_t*", "desc": "成功返回动画对象，失败返回NULL。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象本身。" }, { "type": "double", "name": "from", "desc": "prop起始值。" }, { "type": "double", "name": "to", "desc": "prop结束值。" } ], "annotation": {}, "desc": "设置动画对象的参数。", "name": "widget_animator_prop_set_params", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "widget_animators/widget_animator_prop.h", "desc": "通过修改对象的指定属性形成动画效果。", "name": "widget_animator_prop_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "ubjson_write_callback_t", "name": "write", "desc": "真正写入数据的函数。" }, { "type": "void*", "name": "ctx", "desc": "write函数的上下文。" } ], "annotation": {}, "desc": "初始化。", "name": "ubjson_writer_init", "return": { "type": "ubjson_writer_t*", "desc": "返回writer对象。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "value", "desc": "key的名称。" } ], "annotation": {}, "desc": "写入key。", "name": "ubjson_writer_write_key", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" } ], "annotation": {}, "desc": "写入null。", "name": "ubjson_writer_write_null", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" } ], "annotation": {}, "desc": "写入noop。", "name": "ubjson_writer_write_noop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" } ], "annotation": {}, "desc": "写入true。", "name": "ubjson_writer_write_true", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" } ], "annotation": {}, "desc": "写入false。", "name": "ubjson_writer_write_false", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "int32_t", "name": "value", "desc": "要写入的值。" } ], "annotation": {}, "desc": "写入int。", "name": "ubjson_writer_write_int", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "int8_t", "name": "value", "desc": "要写入的值。" } ], "annotation": {}, "desc": "写入int8。", "name": "ubjson_writer_write_int8", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "uint8_t", "name": "value", "desc": "要写入的值。" } ], "annotation": {}, "desc": "写入uint8。", "name": "ubjson_writer_write_uint8", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "int16_t", "name": "value", "desc": "要写入的值。" } ], "annotation": {}, "desc": "写入int16。", "name": "ubjson_writer_write_int16", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "int32_t", "name": "value", "desc": "要写入的值。" } ], "annotation": {}, "desc": "写入int32。", "name": "ubjson_writer_write_int32", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "int64_t", "name": "value", "desc": "要写入的值。" } ], "annotation": {}, "desc": "写入int64。", "name": "ubjson_writer_write_int64", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "float", "name": "value", "desc": "要写入的值。" } ], "annotation": {}, "desc": "写入float。", "name": "ubjson_writer_write_float32", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "double", "name": "value", "desc": "要写入的值。" } ], "annotation": {}, "desc": "写入double。", "name": "ubjson_writer_write_float64", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "char", "name": "value", "desc": "要写入的值。" } ], "annotation": {}, "desc": "写入char。", "name": "ubjson_writer_write_char", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "value", "desc": "要写入的字符串。" } ], "annotation": {}, "desc": "写入str。", "name": "ubjson_writer_write_str", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "value", "desc": "要写入的字符串。" }, { "type": "uint32_t", "name": "len", "desc": "字符串的长度。" } ], "annotation": {}, "desc": "写入str。", "name": "ubjson_writer_write_str_len", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "object_t*", "name": "obj", "desc": "要写入的对象。" } ], "annotation": {}, "desc": "写入obj。", "name": "ubjson_writer_write_object", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" } ], "annotation": {}, "desc": "写入数组开始。\n> 即： [", "name": "ubjson_writer_write_array_begin", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" } ], "annotation": {}, "desc": "写入数组结束。\n> 即： ]", "name": "ubjson_writer_write_array_end", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" } ], "annotation": {}, "desc": "写入对象开始。\n> 即： {", "name": "ubjson_writer_write_object_begin", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" } ], "annotation": {}, "desc": "写入对象结束。\n> 即：}", "name": "ubjson_writer_write_object_end", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const void*", "name": "data", "desc": "数据。" }, { "type": "uint32_t", "name": "size", "desc": "数据长度。" } ], "annotation": {}, "desc": "写入二进制数据。", "name": "ubjson_writer_write_data", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "key", "desc": "键值。" } ], "annotation": {}, "desc": "写key和对象的开始。\n\n> 即：\"key\": {", "name": "ubjson_writer_write_kv_object_begin", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "key", "desc": "键名。" }, { "type": "object_t*", "name": "value", "desc": "对象。" } ], "annotation": {}, "desc": "写key和对象。\n\n> 即：\"key\": { object }", "name": "ubjson_writer_write_kv_object", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "key", "desc": "键名。" }, { "type": "int32_t", "name": "value", "desc": "值。" } ], "annotation": {}, "desc": "写入key和int的值。\n\n> 即：\"key\": value", "name": "ubjson_writer_write_kv_int", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "key", "desc": "键名。" }, { "type": "int64_t", "name": "value", "desc": "值。" } ], "annotation": {}, "desc": "写入key和int64_t的值。\n\n> 即：\"key\": value", "name": "ubjson_writer_write_kv_int64", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "key", "desc": "键名。" }, { "type": "float", "name": "value", "desc": "值。" } ], "annotation": {}, "desc": "写入key和float的值。\n\n> 即：\"key\": value", "name": "ubjson_writer_write_kv_float", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "key", "desc": "键名。" }, { "type": "double", "name": "value", "desc": "值。" } ], "annotation": {}, "desc": "写入key和double的值。\n\n> 即：\"key\": value", "name": "ubjson_writer_write_kv_double", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "key", "desc": "键名。" }, { "type": "bool_t", "name": "value", "desc": "值。" } ], "annotation": {}, "desc": "写入key和bool的值。\n\n> 即：\"key\": value", "name": "ubjson_writer_write_kv_bool", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "key", "desc": "键名。" }, { "type": "const char*", "name": "value", "desc": "字符串。" } ], "annotation": {}, "desc": "写入key和str的值。\n\n> 即：\"key\": value", "name": "ubjson_writer_write_kv_str", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "key", "desc": "键名。" }, { "type": "const char*", "name": "value", "desc": "字符串。" }, { "type": "uint32_t", "name": "len", "desc": "字符串的长度。" } ], "annotation": {}, "desc": "写入key和str的值。\n\n> 即：\"key\": value", "name": "ubjson_writer_write_kv_str_len", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ubjson_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "const char*", "name": "key", "desc": "键名。" }, { "type": "value_t*", "name": "value", "desc": "值。" } ], "annotation": {}, "desc": "写入key和value_t的值。\n\n> 即：\"key\": value", "name": "ubjson_writer_write_kv_value", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "ubjson/ubjson_writer.h", "desc": "ubjson writer", "name": "ubjson_writer_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "void*", "name": "data", "desc": "数据。" }, { "type": "uint32_t", "name": "size", "desc": "数据的长度。" }, { "type": "ubjson_on_key_value_t", "name": "on_key_value", "desc": "回调函数。" }, { "type": "void*", "name": "ctx", "desc": "回调函数的上下文。" } ], "annotation": { "static": true }, "desc": "解析ubjson数据，遇到key/value时调用提供的回调函数。", "name": "ubjson_parse", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "void*", "name": "data", "desc": "数据。" }, { "type": "uint32_t", "name": "size", "desc": "数据的长度。" } ], "annotation": { "static": true }, "desc": "解析ubjson数据，生成object对象。", "name": "ubjson_to_object", "return": { "type": "void*", "desc": "返回object表示的数据。" } }, { "params": [ { "type": "void*", "name": "data", "desc": "数据。" }, { "type": "uint32_t", "name": "size", "desc": "数据的长度。" } ], "annotation": { "static": true }, "desc": "将ubjson数据打印到控制台。", "name": "ubjson_dump", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "ubjson/ubjson_parser.h", "desc": "ubjson parser", "name": "ubjson_parser_t", "annotation": { "fake": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "font_loader_t*", "name": "loader", "desc": "loader对象。" }, { "type": "const char*", "name": "name", "desc": "字体名字。" }, { "type": "uint8_t*", "name": "buff", "desc": "字体数据。" }, { "type": "uint32_t", "name": "size", "desc": "字体数据长度。" } ], "annotation": {}, "desc": "加载字体。", "name": "font_loader_load", "return": { "type": "font_t*", "desc": "成功返回font，失败返回NULL。" } } ], "events": [], "properties": [], "header": "base/font_loader.h", "desc": "字体加载接口。", "name": "font_loader_t", "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true }, "desc": "获取缺省的字体管理器。", "name": "font_manager", "return": { "type": "font_manager_t*", "desc": "返回字体管理器对象。" } }, { "params": [ { "type": "font_manager_t*", "name": "fm", "desc": "字体管理器对象。" } ], "annotation": {}, "desc": "设置缺省的字体管理器。", "name": "font_manager_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "font_loader_t*", "name": "loader", "desc": "字体加载器。" } ], "annotation": { "constructor": true }, "desc": "创建字体管理器。", "name": "font_manager_create", "return": { "type": "font_manager_t*", "desc": "返回字体管理器对象。" } }, { "params": [ { "type": "font_manager_t*", "name": "fm", "desc": "字体管理器对象。" }, { "type": "font_loader_t*", "name": "loader", "desc": "字体加载器。" } ], "annotation": { "constructor": true }, "desc": "初始化字体管理器。", "name": "font_manager_init", "return": { "type": "font_manager_t*", "desc": "返回字体管理器对象。" } }, { "params": [ { "type": "font_manager_t*", "name": "imm", "desc": "字体管理器对象。" }, { "type": "assets_manager_t*", "name": "assets_manager", "desc": "资源管理器。" } ], "annotation": {}, "desc": "设置资源管理器对象\n\n之所以需要设置资源管理器对象，而不是使用缺省的资源管理器对象，是因为在designer中有两个字体管理器：\n\n* 一个用于designer本身加载字体。\n\n* 一个用于被设计的窗口加载字体。\n\n这两个字体管理器需要从不同的路径加载资源。", "name": "font_manager_set_assets_manager", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "font_manager_t*", "name": "fm", "desc": "字体管理器对象。" }, { "type": "char*", "name": "name", "desc": "字体名。" }, { "type": "font_t*", "name": "font", "desc": "字体。" } ], "annotation": {}, "desc": "向缓存中加入字体。", "name": "font_manager_add_font", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "font_manager_t*", "name": "fm", "desc": "字体管理器对象。" }, { "type": "char*", "name": "name", "desc": "字体名，为NULL时使用缺省字体。" }, { "type": "font_size_t", "name": "size", "desc": "字体的大小。" } ], "annotation": {}, "desc": "从缓存中查找字体，如果没找到，再加载字体，并缓存。", "name": "font_manager_get_font", "return": { "type": "font_t*", "desc": "返回字体对象。" } }, { "params": [ { "type": "font_manager_t*", "name": "fm", "desc": "字体管理器对象。" }, { "type": "char*", "name": "name", "desc": "字体名，为NULL时使用缺省字体。" }, { "type": "font_size_t", "name": "size", "desc": "字体的大小(矢量字体指定为0即可)。" } ], "annotation": { "scriptable": true }, "desc": "卸载指定的字体。", "name": "font_manager_unload_font", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "font_manager_t*", "name": "fm", "desc": "字体管理器对象。" }, { "type": "uint32_t", "name": "cache_size", "desc": "每种字体保留缓存字模的个数。" } ], "annotation": { "scriptable": true }, "desc": "清除最久没有被使用的缓冲字模。", "name": "font_manager_shrink_cache", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "font_manager_t*", "name": "fm", "desc": "字体管理器对象。" } ], "annotation": { "scriptable": true }, "desc": "卸载全部字体。", "name": "font_manager_unload_all", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "font_manager_t*", "name": "fm", "desc": "字体管理器对象。" } ], "annotation": {}, "desc": "析构字体管理器。", "name": "font_manager_deinit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "font_manager_t*", "name": "fm", "desc": "字体管理器对象。" } ], "annotation": {}, "desc": "析构并释放字体管理器。", "name": "font_manager_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "loader", "desc": "字体加载器。", "type": "font_loader_t*", "annotation": { "private": true } }, { "name": "assets_manager", "desc": "资源管理器。", "type": "assets_manager_t*", "annotation": { "private": true } } ], "header": "base/font_manager.h", "desc": "字体管理器，负责字体的加载和缓存管理。\n(如果使用nanovg，字体由nanovg内部管理)", "name": "font_manager_t", "annotation": { "scriptable": true }, "level": 1 }, { "type": "enum", "desc": "字模格式常量定义。", "consts": [ { "desc": "每个像素占用1个字节(缺省)。", "name": "GLYPH_FMT_ALPHA" }, { "desc": "每个像素占用1个比特。", "name": "GLYPH_FMT_MONO" }, { "desc": "每个像素占用4个字节。", "name": "GLYPH_FMT_RGBA" } ], "header": "base/font.h", "name": "glyph_format_t", "prefix": "GLYPH_FMT_", "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true }, "desc": "创建glyph对象。", "name": "glyph_create", "return": { "type": "glyph_t*", "desc": "glyph对象。" } }, { "params": [], "annotation": { "constructor": true }, "desc": "克隆glyph对象。", "name": "glyph_clone", "return": { "type": "glyph_t*", "desc": "glyph对象。" } }, { "params": [ { "type": "glyph_t*", "name": "glyph", "desc": "glyph对象。" } ], "annotation": { "deconstructor": true }, "desc": "销毁glyph对象。", "name": "glyph_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "x", "desc": "x坐标。", "type": "int16_t", "annotation": { "readable": true } }, { "name": "y", "desc": "y坐标。", "type": "int16_t", "annotation": { "readable": true } }, { "name": "w", "desc": "宽度。", "type": "uint16_t", "annotation": { "readable": true } }, { "name": "h", "desc": "高度。", "type": "uint16_t", "annotation": { "readable": true } }, { "name": "advance", "desc": "占位宽度。", "type": "uint16_t", "annotation": { "readable": true } }, { "name": "format", "desc": "格式。", "type": "uint8_t", "annotation": { "readable": true } }, { "name": "pitch", "desc": "pitch。", "type": "uint8_t", "annotation": { "readable": true } }, { "name": "data", "desc": "数据。", "type": "const uint8_t*", "annotation": { "readable": true } } ], "header": "base/font.h", "desc": "代表一个字符的字模。", "name": "glyph_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "font_t*", "name": "font", "desc": "font对象。" }, { "type": "font_size_t", "name": "font_size", "desc": "字体大小。" } ], "annotation": {}, "desc": "获取字体的高度信息。", "name": "font_get_vmetrics", "return": { "type": "font_vmetrics_t", "desc": "返回字体的高度信息。" } }, { "params": [ { "type": "font_t*", "name": "font", "desc": "font对象。" }, { "type": "const char*", "name": "font_name", "desc": "字体名称。" }, { "type": "font_size_t", "name": "font_size", "desc": "字体大小。" } ], "annotation": {}, "desc": "检查当前字体是否与指定名称和大小相匹配。", "name": "font_match", "return": { "type": "int32_t", "desc": "返回TRUE表示成功，FALSE表示失败。" } }, { "params": [ { "type": "font_t*", "name": "font", "desc": "font对象。" }, { "type": "wchar_t", "name": "chr", "desc": "字符。" }, { "type": "font_size_t", "name": "font_size", "desc": "字体大小。" }, { "type": "glyph_t*", "name": "glyph", "desc": "返回字模数据。" } ], "annotation": {}, "desc": "获取指定字符和大小的字模。", "name": "font_get_glyph", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "font_t*", "name": "font", "desc": "font对象。" }, { "type": "uint32_t", "name": "cache_size", "desc": "保留缓存字模的个数。" } ], "annotation": {}, "desc": "清除最近没使用的字模。", "name": "font_shrink_cache", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "font_t*", "name": "font", "desc": "font对象。" } ], "annotation": { "deconstructor": true }, "desc": "销毁font对象。", "name": "font_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/font.h", "desc": "代表一种字体。", "name": "font_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "bitmap_t*", "name": "fb", "desc": "framebuffer对象。" }, { "type": "rect_t*", "name": "dst", "desc": "要填充的目标区域。" }, { "type": "color_t", "name": "c", "desc": "颜色。" } ], "annotation": {}, "desc": "用颜色填充指定的区域。", "name": "g2d_fill_rect", "export": "none", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败，返回失败则上层用软件实现。" } }, { "params": [ { "type": "bitmap_t*", "name": "fb", "desc": "framebuffer对象。" }, { "type": "bitmap_t*", "name": "img", "desc": "图片对象。" }, { "type": "rect_t*", "name": "src", "desc": "要拷贝的区域。" }, { "type": "xy_t", "name": "dx", "desc": "目标位置的x坐标。" }, { "type": "xy_t", "name": "dy", "desc": "目标位置的y坐标。" } ], "annotation": {}, "desc": "把图片指定的区域拷贝到framebuffer中。", "name": "g2d_copy_image", "export": "none", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败，返回失败则上层用软件实现。" } }, { "params": [ { "type": "bitmap_t*", "name": "fb", "desc": "framebuffer对象。" }, { "type": "bitmap_t*", "name": "img", "desc": "图片对象。" }, { "type": "rect_t*", "name": "src", "desc": "要旋转并拷贝的区域。" }, { "type": "lcd_orientation_t", "name": "o", "desc": "旋转角度(一般支持90度即可)。" } ], "annotation": {}, "desc": "把图片指定的区域进行旋转并拷贝到framebuffer相应的区域，本函数主要用于辅助实现横屏和竖屏的切换，一般支持90度旋转即可。", "name": "g2d_rotate_image", "export": "none", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败，返回失败则上层用软件实现。" } }, { "params": [ { "type": "bitmap_t*", "name": "fb", "desc": "framebuffer对象。" }, { "type": "bitmap_t*", "name": "img", "desc": "图片对象。" }, { "type": "rect_t*", "name": "dst", "desc": "目的区域。" }, { "type": "rect_t*", "name": "src", "desc": "源区域。" }, { "type": "uint8_t", "name": "global_alpha", "desc": "全局alpha。" } ], "annotation": {}, "desc": "把图片指定的区域渲染到framebuffer指定的区域，src的大小和dst的大小不一致则进行缩放。\n1.硬件不支持缩放，则返回NOT_IMPL。\n2.硬件不支持全局alpha，global_alpha!=0xff时返回NOT_IMPL。", "name": "g2d_blend_image", "export": "none", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败，返回失败则上层用软件实现。" } } ], "events": [], "properties": [], "header": "base/g2d.h", "desc": "2D加速接口。", "name": "g2d_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "glyph_cache_t*", "name": "cache", "desc": "cache对象。" }, { "type": "uint32_t", "name": "capacity", "desc": "最大容量。" }, { "type": "tk_destroy_t", "name": "destroy_glyph", "desc": "销毁函数。" } ], "annotation": {}, "desc": "初始化glyph_cache对象。", "name": "glyph_cache_init", "return": { "type": "glyph_cache_t*", "desc": "返回cache对象。" } }, { "params": [ { "type": "glyph_cache_t*", "name": "cache", "desc": "cache对象。" }, { "type": "wchar_t", "name": "code", "desc": "字符。" }, { "type": "font_size_t", "name": "size", "desc": "字体大小。" }, { "type": "glyph_t", "name": "g", "desc": "glyph对象。" } ], "annotation": {}, "desc": "增加一个glyph对象到cache。", "name": "glyph_cache_add", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "glyph_cache_t*", "name": "cache", "desc": "cache对象。" }, { "type": "wchar_t", "name": "code", "desc": "字符。" }, { "type": "font_size_t", "name": "size", "desc": "字体大小。" }, { "type": "glyph_t", "name": "g", "desc": "glyph对象(用于返回glyph)。" } ], "annotation": {}, "desc": "查找glyph对象。", "name": "glyph_cache_lookup", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "glyph_cache_t*", "name": "cache", "desc": "cache对象。" }, { "type": "uint32_t", "name": "cache_size", "desc": "保留cache个数。" } ], "annotation": {}, "desc": "释放部分glyph。", "name": "glyph_cache_shrink", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "glyph_cache_t*", "name": "cache", "desc": "cache对象。" } ], "annotation": {}, "desc": "释放全部cache。", "name": "glyph_cache_deinit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/glyph_cache.h", "desc": "glyph cache", "name": "glyph_cache_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "bitmap_t*", "name": "bitmap", "desc": "位图对象。" } ], "annotation": {}, "desc": "为位图创建缓冲区。", "name": "graphic_buffer_create_for_bitmap", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "const uint8_t*", "name": "data", "desc": "数据。" }, { "type": "uint32_t", "name": "w", "desc": "宽度。" }, { "type": "uint32_t", "name": "h", "desc": "宽度。" }, { "type": "bitmap_format_t", "name": "format", "desc": "格式。" } ], "annotation": {}, "desc": "创建缓冲区。\n\n> 为了兼容raw图像。", "name": "graphic_buffer_create_with_data", "return": { "type": "graphic_buffer_t*", "desc": "返回缓存区。" } }, { "params": [ { "type": "graphic_buffer_t*", "name": "buffer", "desc": "图像缓冲区对象。" } ], "annotation": {}, "desc": "为读取数据而锁定缓冲区。", "name": "graphic_buffer_lock_for_read", "return": { "type": "uint8_t*", "desc": "返回缓存区的首地址。" } }, { "params": [ { "type": "graphic_buffer_t*", "name": "buffer", "desc": "图像缓冲区对象。" } ], "annotation": {}, "desc": "为修改数据而锁定缓冲区。", "name": "graphic_buffer_lock_for_write", "return": { "type": "uint8_t*", "desc": "返回缓存区的首地址。" } }, { "params": [ { "type": "graphic_buffer_t*", "name": "buffer", "desc": "图像缓冲区对象。" } ], "annotation": {}, "desc": "解锁缓冲区。", "name": "graphic_buffer_unlock", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "graphic_buffer_t*", "name": "buffer", "desc": "图像缓冲区对象。" }, { "type": "void*", "name": "data", "desc": "内存数据。" }, { "type": "uint32_t", "name": "w", "desc": "宽度。" }, { "type": "uint32_t", "name": "h", "desc": "宽度。" } ], "annotation": {}, "desc": "附件到指定的内存。", "name": "graphic_buffer_attach", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "graphic_buffer_t*", "name": "buffer", "desc": "图像缓冲区对象。" }, { "type": "bitmap_t*", "name": "bitmap", "desc": "位图对象。" } ], "annotation": {}, "desc": "用于检查graphic buffer的有效性。", "name": "graphic_buffer_is_valid_for", "return": { "type": "bool_t", "desc": "返回TRUE表示有效，否则表示无效。" } }, { "params": [ { "type": "graphic_buffer_t*", "name": "buffer", "desc": "图像缓冲区对象。" } ], "annotation": {}, "desc": "销毁缓冲区。", "name": "graphic_buffer_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/graphic_buffer.h", "desc": "graphic_buffer。", "name": "graphic_buffer_t", "level": 1 }, { "type": "class", "methods": [], "events": [], "properties": [], "header": "base/hscrollable.h", "desc": "帮助实现控件左右滚动的效果。", "name": "hscrollable_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "idle_func_t", "name": "on_idle", "desc": "idle回调函数，回调函数返回RET_REPEAT，则下次继续执行，否则自动移出。" }, { "type": "void*", "name": "ctx", "desc": "idle回调函数的上下文。" } ], "annotation": { "scriptable": "custom", "static": true }, "desc": "增加一个idle。", "name": "idle_add", "return": { "type": "uint32_t", "desc": "返回idle的ID，0表示失败。" } }, { "params": [ { "type": "idle_func_t", "name": "on_idle", "desc": "idle回调函数。" }, { "type": "void*", "name": "ctx", "desc": "idle回调函数的上下文。" } ], "annotation": { "static": true }, "desc": "用于非GUI线程增加一个idle，本函数向主循环的事件队列中发送一个增加idle的请求。", "name": "idle_queue", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "uint32_t", "name": "idle_id", "desc": "idleID。" } ], "annotation": { "scriptable": true, "static": true }, "desc": "删除指定的idle。", "name": "idle_remove", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "uint32_t", "name": "idle_id", "desc": "idleID。" }, { "type": "tk_destroy_t", "name": "on_destroy", "desc": "回调函数。" }, { "type": "void*", "name": "on_destroy_ctx", "desc": "回调函数上下文。" } ], "annotation": {}, "desc": "设置一个回调函数，在idle被销毁时调用(方便脚本语言去释放回调函数)。", "name": "idle_set_on_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": {}, "desc": "调用全部idle的函数。", "name": "idle_dispatch", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "static": true }, "desc": "返回idle的个数。", "name": "idle_count", "return": { "type": "uint32_t", "desc": "返回idle的个数。" } } ], "events": [], "properties": [], "header": "base/idle.h", "desc": "idle可以看作是duration为0的定时器。\n\n> idle可以用来实现一些异步处理。\n\n示例：\n\n```c\nstatic ret_t something_on_idle(const idle_info_t* info) {\nwidget_t* widget = WIDGET(info->ctx);\nedit_t* edit = EDIT(widget);\n...\nreturn RET_REMOVE;\n}\n\n...\n\nidle_add(something_on_idle, edit);\n\n```\n\n> 在非GUI线程请用idle\\_queue。", "name": "idle_t", "annotation": { "scriptable": true, "fake": true }, "level": 1 }, { "params": [ { "type": "const wchar_t*", "name": "s", "desc": "源字符串。" } ], "annotation": { "global": true }, "desc": "获取一个新的内存保存s串。", "name": "wcs_dup", "return": { "type": "wchar_t*", "desc": "返回新的字符串地址。" }, "type": "method", "header": "tkc/wstr.h", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "image_loader_t*", "name": "loader", "desc": "loader对象。" }, { "type": "const asset_info_t*", "name": "asset", "desc": "资源。" }, { "type": "bitmap_t*", "name": "bitmap", "desc": "用于返回位图对象。" } ], "annotation": {}, "desc": "加载图片。", "name": "image_loader_load", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "image_loader_t*", "name": "loader", "desc": "loader对象。" } ], "annotation": { "static": true }, "desc": "注册图片加载器。", "name": "image_loader_register", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "image_loader_t*", "name": "loader", "desc": "loader对象。" } ], "annotation": { "static": true }, "desc": "注销图片加载器。", "name": "image_loader_unregister", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "const asset_info_t*", "name": "asset", "desc": "资源。" }, { "type": "bitmap_t*", "name": "bitmap", "desc": "用于返回位图对象。" } ], "annotation": { "static": true }, "desc": "查找满足条件加载器并加载图片。", "name": "image_loader_load_image", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/image_loader.h", "desc": "图片加载接口。", "name": "image_loader_t", "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true, "scriptable": true }, "desc": "获取缺省的图片管理器。", "name": "image_manager", "alias": "image_manager_instance", "return": { "type": "image_manager_t*", "desc": "返回图片管理器对象。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" } ], "annotation": {}, "desc": "设置缺省的图片管理器。", "name": "image_manager_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "constructor": true }, "desc": "创建图片管理器。", "name": "image_manager_create", "return": { "type": "image_manager_t*", "desc": "返回图片管理器对象。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" } ], "annotation": { "constructor": true }, "desc": "初始化图片管理器。", "name": "image_manager_init", "return": { "type": "image_manager_t*", "desc": "返回图片管理器对象。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" }, { "type": "char*", "name": "name", "desc": "图片名称。" }, { "type": "bitmap_t*", "name": "image", "desc": "用于返回图片。" } ], "annotation": { "scriptable": true }, "desc": "获取指定的图片。\n先从缓存查找，如果没找到，再加载并缓存。", "name": "image_manager_get_bitmap", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" }, { "type": "char*", "name": "name", "desc": "图片名称。" } ], "annotation": { "scriptable": true }, "desc": "预加载指定的图片。", "name": "image_manager_preload", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" }, { "type": "uint32_t", "name": "time_delta_s", "desc": "时间范围，单位为秒。" } ], "annotation": {}, "desc": "从图片管理器中卸载指定时间内没有使用的图片。", "name": "image_manager_unload_unused", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" } ], "annotation": {}, "desc": "从图片管理器中卸载全部图片。", "name": "image_manager_unload_all", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" }, { "type": "bitmap_t*", "name": "image", "desc": "图片。" } ], "annotation": {}, "desc": "从图片管理器中卸载指定的图片。", "name": "image_manager_unload_bitmap", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" }, { "type": "bitmap_t*", "name": "image", "desc": "返回图片信息。" } ], "annotation": {}, "desc": "更新缓存中图片的specific信息。", "name": "image_manager_update_specific", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" }, { "type": "assets_manager_t*", "name": "assets_manager", "desc": "资源管理器。" } ], "annotation": {}, "desc": "设置资源管理器对象。\n\n之所以需要设置资源管理器对象，而不是使用缺省的资源管理器对象，是因为在designer中有两个图片管理器：\n\n* 一个用于designer本身加载图片。\n\n* 一个用于被设计的窗口加载图片。\n\n这两个图片管理器需要从不同的路径加载资源。", "name": "image_manager_set_assets_manager", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" } ], "annotation": {}, "desc": "析构图片管理器。", "name": "image_manager_deinit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "image_manager_t*", "name": "imm", "desc": "图片管理器对象。" } ], "annotation": {}, "desc": "析构并释放图片管理器。", "name": "image_manager_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "images", "desc": "缓存的图片。", "type": "darray_t", "annotation": { "private": true } }, { "name": "assets_manager", "desc": "资源管理器。", "type": "assets_manager_t*", "annotation": { "private": true } } ], "header": "base/image_manager.h", "desc": "图片管理器。负责加载，解码和缓存图片。", "name": "image_manager_t", "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "input_device_status_t*", "name": "ids", "desc": "输入设备状态管理器对象。" } ], "annotation": { "constructor": true }, "desc": "初始化输入设备状态管理器。", "name": "input_device_status_init", "return": { "type": "input_device_status_t*", "desc": "返回输入设备状态管理器对象。" } }, { "params": [ { "type": "input_device_status_t*", "name": "ids", "desc": "输入设备状态管理器对象。" }, { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" }, { "type": "event_t*", "name": "e", "desc": "事件对象。" } ], "annotation": {}, "desc": "对输入事件进行处理，然后分发给widget。", "name": "input_device_status_on_input_event", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/input_device_status.h", "desc": "输入设备状态管理器。本类仅供窗口管理器内部使用。", "name": "input_device_status_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" } ], "annotation": { "constructor": true }, "desc": "创建输入法引擎对象。", "name": "input_engine_create", "return": { "type": "input_engine_t*", "desc": "返回输入法引擎对象。" } }, { "params": [ { "type": "input_engine_t*", "name": "engine", "desc": "输入法引擎对象。" } ], "annotation": { "deconstructor": true }, "desc": "销毁输入法引擎对象。", "name": "input_engine_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_engine_t*", "name": "engine", "desc": "输入法引擎对象。" } ], "annotation": {}, "desc": "清除所有输入的按键组合和候选字。", "name": "input_engine_reset_input", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_engine_t*", "name": "engine", "desc": "输入法引擎对象。" }, { "type": "int", "name": "key", "desc": "键值。" } ], "annotation": {}, "desc": "输入新的按键，并更新候选字。", "name": "input_engine_input", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_engine_t*", "name": "engine", "desc": "输入法引擎对象。" }, { "type": "const char*", "name": "keys", "desc": "按键组合。" } ], "annotation": {}, "desc": "根据按键组合，更新候选字，并通过输入法对象提交候选字和pre候选字。", "name": "input_engine_search", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "keys", "desc": "当前的按键组合。", "type": "str_t", "annotation": { "private": true } }, { "name": "candidates", "desc": "当前按键组合对应的候选字列表。", "type": "char*", "annotation": { "private": true } }, { "name": "candidates_nr", "desc": "当前按键组合对应的候选字/词个数。", "type": "uint32_t", "annotation": { "private": true } } ], "header": "base/input_engine.h", "desc": "输入法引擎接口。\n\n常见的实现方式有以下几种：\n\n* 空实现。用于不需要输入法的嵌入式平台。\n\n* 拼音输入法实现。用于需要输入法的嵌入式平台。\n\n```graphviz\n[default_style]\n\ninput_engine_pinyin_t -> input_engine_t[arrowhead=empty style=dashed]\ninput_engine_null_t -> input_engine_t[arrowhead=empty style=dashed]\n\n```", "name": "input_engine_t", "level": 1 }, { "type": "enum", "desc": "输入类型常量定义。", "consts": [ { "desc": "文本。字符串属性值：text", "name": "INPUT_TEXT" }, { "desc": "整数。字符串属性值：int", "name": "INPUT_INT" }, { "desc": "非负整数。字符串属性值：uint", "name": "INPUT_UINT" }, { "desc": "16进制整数。字符串属性值：hex", "name": "INPUT_HEX" }, { "desc": "浮点数。字符串属性值：float", "name": "INPUT_FLOAT" }, { "desc": "非负浮点数。字符串属性值：ufloat", "name": "INPUT_UFLOAT" }, { "desc": "邮件地址。字符串属性值：email", "name": "INPUT_EMAIL" }, { "desc": "密码。字符串属性值：password", "name": "INPUT_PASSWORD" }, { "desc": "电话号码。字符串属性值：phone", "name": "INPUT_PHONE" }, { "desc": "IP Addr V4(如：192.168.1.1)。字符串属性值：ipv4", "name": "INPUT_IPV4" }, { "desc": "日期(如：2020/02/20)。字符串属性值：date", "name": "INPUT_DATE" }, { "desc": "时间(时分，如：12:00)。字符串属性值：time", "name": "INPUT_TIME" }, { "desc": "时间(时分秒，如：12:00:00)。字符串属性值：time_full", "name": "INPUT_TIME_FULL" }, { "desc": "使用自定义的软键盘(如计算器等应用不希望弹出系统软键盘)。字符串属性值：custom", "name": "INPUT_CUSTOM" }, { "desc": "使用自定义的密码软键盘。字符串属性值：custom_password", "name": "INPUT_CUSTOM_PASSWORD" } ], "header": "base/input_method.h", "name": "input_type_t", "prefix": "INPUT_", "annotation": { "scriptable": true }, "level": 1 }, { "params": [ { "type": "const wchar_t*", "name": "s", "desc": "串地址。" } ], "annotation": { "global": true }, "desc": "获取字符串长度。", "name": "wcs_len", "return": { "type": "size_t", "desc": "返回串长度'\\0'结尾。" }, "type": "method", "header": "tkc/wstr.h", "level": 1 }, { "params": [ { "type": "const wchar_t*", "name": "s1", "desc": "目标串。" }, { "type": "const wchar_t*", "name": "s2", "desc": "源串。" } ], "annotation": { "global": true }, "desc": "比较字符串", "name": "wcs_cmp", "return": { "type": "int", "desc": "小于0表示s1s2。" }, "type": "method", "header": "tkc/wstr.h", "level": 1 }, { "params": [ { "type": "wchar_t*", "name": "s1", "desc": "目标串。" }, { "type": "const wchar_t*", "name": "s2", "desc": "源串。" } ], "annotation": { "global": true }, "desc": "复制字符串", "name": "wcs_cpy", "return": { "type": "const wchar_t*", "desc": "复制后的串地址。" }, "type": "method", "header": "tkc/wstr.h", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "input_method_t*", "name": "im", "desc": "控件对象。" }, { "type": "event_t*", "name": "e", "desc": "事件。" } ], "annotation": {}, "desc": "分发一个事件。", "name": "input_method_dispatch", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "控件对象。" }, { "type": "event_t*", "name": "e", "desc": "事件。" } ], "annotation": {}, "desc": "分发一个事件当前焦点控件。", "name": "input_method_dispatch_to_widget", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型。" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": {}, "desc": "注册指定事件的处理函数。", "name": "input_method_on", "return": { "type": "uint32_t", "desc": "返回id，用于input_method_off。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "uint32_t", "name": "id", "desc": "input_method_on返回的ID。" } ], "annotation": {}, "desc": "注销指定事件的处理函数。", "name": "input_method_off", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "widget_t*", "name": "widget", "desc": "焦点控件，为NULL时关闭输入法，非NULL时打开输入法。" } ], "annotation": {}, "desc": "打开或关闭输入法。", "name": "input_method_request", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "char*", "name": "text", "desc": "按钮的文本。" }, { "type": "bool_t", "name": "enable", "desc": "按钮的是否可用。" } ], "annotation": {}, "desc": "设置软键盘上的action按钮的信息。", "name": "input_method_update_action_button_info", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" } ], "annotation": {}, "desc": "软键盘上的action按钮被点击时，调用本函数分发EVT_IM_ACTION事件。", "name": "input_method_dispatch_action", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "const char*", "name": "text", "desc": "文本。" } ], "annotation": { "scriptable": true }, "desc": "提交输入文本。", "name": "input_method_commit_text", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "const char*", "name": "lang", "desc": "语言。格式为语言+国家/地区码。如：zh_cn和en_us等。" } ], "annotation": { "scriptable": true }, "desc": "设置语言。\n\n> 有时在同一种语言环境下，也需要输入多种文字，典型的情况是同时输入中文和英文。\n> 比如T9输入法，可以同时支持中文和英文输入，配合软键盘随时切换输入的语言。\n> 数字、小写字母、大写字母和符合也可以视为输入的语言。\n> 主要用于提示输入法引擎选择适当的输入方法。", "name": "input_method_set_lang", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" } ], "annotation": { "scriptable": true }, "desc": "获取语言。", "name": "input_method_get_lang", "return": { "type": "const char*", "desc": "返回语言。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "bool_t", "name": "replace", "desc": "是否替换原来的文本。" }, { "type": "const char*", "name": "text", "desc": "文本。" } ], "annotation": {}, "desc": "提交输入文本。", "name": "input_method_commit_text_ex", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "uint32_t", "name": "key", "desc": "键值。" } ], "annotation": { "scriptable": true }, "desc": "提交按键。", "name": "input_method_dispatch_key", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "const char*", "name": "key", "desc": "键值。" } ], "annotation": { "scriptable": true }, "desc": "提交按键。", "name": "input_method_dispatch_keys", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" } ], "annotation": { "scriptable": true }, "desc": "分发进入预编辑状态的事件。", "name": "input_method_dispatch_preedit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" } ], "annotation": { "scriptable": true }, "desc": "分发确认预编辑状态的事件(提交预编辑内容，退出预编辑状态)。", "name": "input_method_dispatch_preedit_confirm", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" } ], "annotation": { "scriptable": true }, "desc": "分发取消预编辑状态的事件(提交预编辑内容，退出预编辑状态)。", "name": "input_method_dispatch_preedit_abort", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "char*", "name": "strs", "desc": "候选字列表。" }, { "type": "uint32_t", "name": "nr", "desc": "候选字个数。" }, { "type": "int32_t", "name": "selected", "desc": "缺省选中候选字的序数。" } ], "annotation": {}, "desc": "请求显示候选字。", "name": "input_method_dispatch_candidates", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" }, { "type": "char*", "name": "strs", "desc": "候选字列表。" }, { "type": "uint32_t", "name": "nr", "desc": "候选字个数。" }, { "type": "int32_t", "name": "selected", "desc": "缺省选中候选字的序数。" } ], "annotation": {}, "desc": "请求显示预候选字。\n\n> 预候选字: 在有的输入法中，比如T9硬键盘输入时，按下12两个键时，预候选字会显示可用的拼音列表。\n> 从预候选字列表中选择拼音，再查询拼音对应的候选字列表。", "name": "input_method_dispatch_pre_candidates", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": {}, "desc": "创建输入法对象。在具体实现中实现。", "name": "input_method_create", "return": { "type": "input_method_t*", "desc": "成功返回输入法对象，失败返回NULL。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" } ], "annotation": {}, "desc": "销毁输入法对象。在具体实现中实现。", "name": "input_method_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "constructor": true, "scriptable": true }, "desc": "获取全局输入法对象。", "name": "input_method", "alias": "input_method_instance", "return": { "type": "input_method_t*", "desc": "成功返回输入法对象，失败返回NULL。" } }, { "params": [ { "type": "input_method_t*", "name": "im", "desc": "输入法对象。" } ], "annotation": {}, "desc": "设置全局输入法对象。", "name": "input_method_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "widget", "desc": "当前的焦点控件。", "type": "widget_t*", "annotation": { "private": true } }, { "name": "keyboard", "desc": "当前的软件键盘。", "type": "widget_t*", "annotation": { "private": true } }, { "name": "win", "desc": "当前的窗口。", "type": "widget_t*", "annotation": { "private": true } }, { "name": "win_delta_y", "desc": "由于软键盘的弹出，可能会将窗口向上推移，win_delta_y为推移的距离。", "type": "int32_t", "annotation": { "private": true } }, { "name": "win_old_y", "desc": "窗口原来的位置。", "type": "int32_t", "annotation": { "private": true } }, { "name": "action_button_enable", "desc": "软键盘的上的action按钮是否可用。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "action_button_enable", "desc": "软键盘的上的action按钮文本。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "emitter", "desc": "emitter。用于实现dispatch/on/off等功能。", "type": "emitter_t", "annotation": { "private": true } }, { "name": "keyboard_name", "desc": "软键盘资源名称。", "type": "char*", "annotation": { "readable": true } } ], "header": "base/input_method.h", "desc": "输入法接口。\n\n常见的实现方式有以下几种：\n\n* 空实现。用于不需要输入法的嵌入式平台。\n\n* 缺省实现。用于需要输入法的嵌入式平台。\n\n* 基于SDL实现的平台原生输入法。用于桌面系统和手机系统。\n\n```graphviz\n[default_style]\n\ninput_method_default_t -> input_method_t [arrowhead=empty style=dashed]\ninput_method_sdl_t -> input_method_t [arrowhead=empty style=dashed]\ninput_method_null_t -> input_method_t [arrowhead=empty style=dashed]\n\n```\n\n> 输入类型请参考：[input\\_type](input_type_t.md)", "name": "input_method_t", "annotation": { "scriptable": true }, "level": 1 }, { "type": "enum", "desc": "key code。", "consts": [ { "desc": "TK_KEY_RETURN", "name": "TK_KEY_RETURN" }, { "desc": "TK_KEY_ESCAPE", "name": "TK_KEY_ESCAPE" }, { "desc": "TK_KEY_BACKSPACE", "name": "TK_KEY_BACKSPACE" }, { "desc": "TK_KEY_TAB", "name": "TK_KEY_TAB" }, { "desc": "TK_KEY_SPACE", "name": "TK_KEY_SPACE" }, { "desc": "TK_KEY_EXCLAIM", "name": "TK_KEY_EXCLAIM" }, { "desc": "TK_KEY_QUOTEDBL", "name": "TK_KEY_QUOTEDBL" }, { "desc": "TK_KEY_HASH", "name": "TK_KEY_HASH" }, { "desc": "TK_KEY_PERCENT", "name": "TK_KEY_PERCENT" }, { "desc": "TK_KEY_DOLLAR", "name": "TK_KEY_DOLLAR" }, { "desc": "TK_KEY_AMPERSAND", "name": "TK_KEY_AMPERSAND" }, { "desc": "TK_KEY_QUOTE", "name": "TK_KEY_QUOTE" }, { "desc": "TK_KEY_LEFTPAREN", "name": "TK_KEY_LEFTPAREN" }, { "desc": "TK_KEY_RIGHTPAREN", "name": "TK_KEY_RIGHTPAREN" }, { "desc": "TK_KEY_ASTERISK", "name": "TK_KEY_ASTERISK" }, { "desc": "TK_KEY_PLUS", "name": "TK_KEY_PLUS" }, { "desc": "TK_KEY_COMMA", "name": "TK_KEY_COMMA" }, { "desc": "TK_KEY_MINUS", "name": "TK_KEY_MINUS" }, { "desc": "TK_KEY_PERIOD", "name": "TK_KEY_PERIOD" }, { "desc": "TK_KEY_SLASH", "name": "TK_KEY_SLASH" }, { "desc": "TK_KEY_0", "name": "TK_KEY_0" }, { "desc": "TK_KEY_1", "name": "TK_KEY_1" }, { "desc": "TK_KEY_2", "name": "TK_KEY_2" }, { "desc": "TK_KEY_3", "name": "TK_KEY_3" }, { "desc": "TK_KEY_4", "name": "TK_KEY_4" }, { "desc": "TK_KEY_5", "name": "TK_KEY_5" }, { "desc": "TK_KEY_6", "name": "TK_KEY_6" }, { "desc": "TK_KEY_7", "name": "TK_KEY_7" }, { "desc": "TK_KEY_8", "name": "TK_KEY_8" }, { "desc": "TK_KEY_9", "name": "TK_KEY_9" }, { "desc": "TK_KEY_COLON", "name": "TK_KEY_COLON" }, { "desc": "TK_KEY_SEMICOLON", "name": "TK_KEY_SEMICOLON" }, { "desc": "TK_KEY_LESS", "name": "TK_KEY_LESS" }, { "desc": "TK_KEY_EQUAL", "name": "TK_KEY_EQUAL" }, { "desc": "TK_KEY_GREATER", "name": "TK_KEY_GREATER" }, { "desc": "TK_KEY_QUESTION", "name": "TK_KEY_QUESTION" }, { "desc": "TK_KEY_AT", "name": "TK_KEY_AT" }, { "desc": "TK_KEY_LEFTBRACKET", "name": "TK_KEY_LEFTBRACKET" }, { "desc": "TK_KEY_BACKSLASH", "name": "TK_KEY_BACKSLASH" }, { "desc": "TK_KEY_RIGHTBRACKET", "name": "TK_KEY_RIGHTBRACKET" }, { "desc": "TK_KEY_CARET", "name": "TK_KEY_CARET" }, { "desc": "TK_KEY_UNDERSCORE", "name": "TK_KEY_UNDERSCORE" }, { "desc": "TK_KEY_BACKQUOTE", "name": "TK_KEY_BACKQUOTE" }, { "desc": "TK_KEY_a", "name": "TK_KEY_a" }, { "desc": "TK_KEY_b", "name": "TK_KEY_b" }, { "desc": "TK_KEY_c", "name": "TK_KEY_c" }, { "desc": "TK_KEY_d", "name": "TK_KEY_d" }, { "desc": "TK_KEY_e", "name": "TK_KEY_e" }, { "desc": "TK_KEY_f", "name": "TK_KEY_f" }, { "desc": "TK_KEY_g", "name": "TK_KEY_g" }, { "desc": "TK_KEY_h", "name": "TK_KEY_h" }, { "desc": "TK_KEY_i", "name": "TK_KEY_i" }, { "desc": "TK_KEY_j", "name": "TK_KEY_j" }, { "desc": "TK_KEY_k", "name": "TK_KEY_k" }, { "desc": "TK_KEY_l", "name": "TK_KEY_l" }, { "desc": "TK_KEY_m", "name": "TK_KEY_m" }, { "desc": "TK_KEY_n", "name": "TK_KEY_n" }, { "desc": "TK_KEY_o", "name": "TK_KEY_o" }, { "desc": "TK_KEY_p", "name": "TK_KEY_p" }, { "desc": "TK_KEY_q", "name": "TK_KEY_q" }, { "desc": "TK_KEY_r", "name": "TK_KEY_r" }, { "desc": "TK_KEY_s", "name": "TK_KEY_s" }, { "desc": "TK_KEY_t", "name": "TK_KEY_t" }, { "desc": "TK_KEY_u", "name": "TK_KEY_u" }, { "desc": "TK_KEY_v", "name": "TK_KEY_v" }, { "desc": "TK_KEY_w", "name": "TK_KEY_w" }, { "desc": "TK_KEY_x", "name": "TK_KEY_x" }, { "desc": "TK_KEY_y", "name": "TK_KEY_y" }, { "desc": "TK_KEY_z", "name": "TK_KEY_z" }, { "desc": "TK_KEY_A", "name": "TK_KEY_A" }, { "desc": "TK_KEY_B", "name": "TK_KEY_B" }, { "desc": "TK_KEY_C", "name": "TK_KEY_C" }, { "desc": "TK_KEY_D", "name": "TK_KEY_D" }, { "desc": "TK_KEY_E", "name": "TK_KEY_E" }, { "desc": "TK_KEY_F", "name": "TK_KEY_F" }, { "desc": "TK_KEY_G", "name": "TK_KEY_G" }, { "desc": "TK_KEY_H", "name": "TK_KEY_H" }, { "desc": "TK_KEY_I", "name": "TK_KEY_I" }, { "desc": "TK_KEY_J", "name": "TK_KEY_J" }, { "desc": "TK_KEY_K", "name": "TK_KEY_K" }, { "desc": "TK_KEY_L", "name": "TK_KEY_L" }, { "desc": "TK_KEY_M", "name": "TK_KEY_M" }, { "desc": "TK_KEY_N", "name": "TK_KEY_N" }, { "desc": "TK_KEY_O", "name": "TK_KEY_O" }, { "desc": "TK_KEY_P", "name": "TK_KEY_P" }, { "desc": "TK_KEY_Q", "name": "TK_KEY_Q" }, { "desc": "TK_KEY_R", "name": "TK_KEY_R" }, { "desc": "TK_KEY_S", "name": "TK_KEY_S" }, { "desc": "TK_KEY_T", "name": "TK_KEY_T" }, { "desc": "TK_KEY_U", "name": "TK_KEY_U" }, { "desc": "TK_KEY_V", "name": "TK_KEY_V" }, { "desc": "TK_KEY_W", "name": "TK_KEY_W" }, { "desc": "TK_KEY_X", "name": "TK_KEY_X" }, { "desc": "TK_KEY_Y", "name": "TK_KEY_Y" }, { "desc": "TK_KEY_Z", "name": "TK_KEY_Z" }, { "desc": "TK_KEY_DOT", "name": "TK_KEY_DOT" }, { "desc": "TK_KEY_DELETE", "name": "TK_KEY_DELETE" }, { "desc": "TK_KEY_LEFTBRACE", "name": "TK_KEY_LEFTBRACE" }, { "desc": "TK_KEY_RIGHTBRACE", "name": "TK_KEY_RIGHTBRACE" }, { "desc": "TK_KEY_LSHIFT", "name": "TK_KEY_LSHIFT" }, { "desc": "TK_KEY_RSHIFT", "name": "TK_KEY_RSHIFT" }, { "desc": "TK_KEY_LCTRL", "name": "TK_KEY_LCTRL" }, { "desc": "TK_KEY_RCTRL", "name": "TK_KEY_RCTRL" }, { "desc": "TK_KEY_LALT", "name": "TK_KEY_LALT" }, { "desc": "TK_KEY_RALT", "name": "TK_KEY_RALT" }, { "desc": "TK_KEY_CAPSLOCK", "name": "TK_KEY_CAPSLOCK" }, { "desc": "TK_KEY_HOME", "name": "TK_KEY_HOME" }, { "desc": "TK_KEY_END", "name": "TK_KEY_END" }, { "desc": "TK_KEY_INSERT", "name": "TK_KEY_INSERT" }, { "desc": "TK_KEY_UP", "name": "TK_KEY_UP" }, { "desc": "TK_KEY_DOWN", "name": "TK_KEY_DOWN" }, { "desc": "TK_KEY_LEFT", "name": "TK_KEY_LEFT" }, { "desc": "TK_KEY_RIGHT", "name": "TK_KEY_RIGHT" }, { "desc": "TK_KEY_PAGEUP", "name": "TK_KEY_PAGEUP" }, { "desc": "TK_KEY_PAGEDOWN", "name": "TK_KEY_PAGEDOWN" }, { "desc": "TK_KEY_F1", "name": "TK_KEY_F1" }, { "desc": "TK_KEY_F2", "name": "TK_KEY_F2" }, { "desc": "TK_KEY_F3", "name": "TK_KEY_F3" }, { "desc": "TK_KEY_F4", "name": "TK_KEY_F4" }, { "desc": "TK_KEY_F5", "name": "TK_KEY_F5" }, { "desc": "TK_KEY_F6", "name": "TK_KEY_F6" }, { "desc": "TK_KEY_F7", "name": "TK_KEY_F7" }, { "desc": "TK_KEY_F8", "name": "TK_KEY_F8" }, { "desc": "TK_KEY_F9", "name": "TK_KEY_F9" }, { "desc": "TK_KEY_F10", "name": "TK_KEY_F10" }, { "desc": "TK_KEY_F11", "name": "TK_KEY_F11" }, { "desc": "TK_KEY_F12", "name": "TK_KEY_F12" }, { "desc": "TK_KEY_MENU", "name": "TK_KEY_MENU" }, { "desc": "TK_KEY_COMMAND", "name": "TK_KEY_COMMAND" }, { "desc": "TK_KEY_BACK", "name": "TK_KEY_BACK" }, { "desc": "TK_KEY_CANCEL", "name": "TK_KEY_CANCEL" } ], "header": "base/keys.h", "name": "key_code_t", "prefix": "TK_", "annotation": { "scriptable": true }, "level": 1 }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件。" } ], "annotation": { "global": true }, "desc": "调用widget的selflayout。", "name": "widget_layout_self", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" }, "type": "method", "header": "base/layout.h", "level": 1 }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件。" } ], "annotation": { "global": true }, "desc": "调用widget默认的childrenlayout。", "name": "widget_layout_children_default", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" }, "type": "method", "header": "base/layout.h", "level": 1 }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件。" } ], "annotation": { "global": true }, "desc": "对floating属性的子控件进行layout。", "name": "widget_layout_floating_children", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" }, "type": "method", "header": "base/layout.h", "level": 1 }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件。" }, { "type": "darray_t*", "name": "result", "desc": "返回队列。" }, { "type": "bool_t", "name": "keep_disable", "desc": "是否保留非enable状态的控件。" }, { "type": "bool_t", "name": "keep_invisible", "desc": "是否保留非visible状态的控件。" } ], "annotation": { "global": true }, "desc": "获取受childrenlayout控件的子控件队列。", "name": "widget_get_children_for_layout", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" }, "type": "method", "header": "base/layout.h", "level": 1 }, { "params": [ { "type": "const wchar_t*", "name": "s", "desc": "wchar_t*。" }, { "type": "wchar_t", "name": "c", "desc": "wchar_t。" } ], "annotation": { "global": true }, "desc": "查找字符位置", "name": "wcs_chr", "return": { "type": "const wchar_t*", "desc": "返回找到c的地址。" }, "type": "method", "header": "tkc/wstr.h", "level": 1 }, { "type": "enum", "desc": "LCD绘制模式常量定义。", "consts": [ { "desc": "正常绘制。", "name": "LCD_DRAW_NORMAL" }, { "desc": "绘制窗口动画，两个窗口无重叠。\n在该模式下，可以直接绘制到显存，不用绘制到framebuffer中。", "name": "LCD_DRAW_ANIMATION" }, { "desc": "绘制窗口动画，两个窗口有重叠。\n(目前无特殊用途)。", "name": "LCD_DRAW_ANIMATION_OVERLAP" }, { "desc": "如果lcd支持swap操作，在特殊情况下，可以使用该模式提速。", "name": "LCD_DRAW_SWAP" }, { "desc": "离线模式绘制(仅适用于framebuffer)。\n在该模式下，绘制的内容不会显示出来，但可以用take_snapshot取出来，主要用于窗口动画。", "name": "LCD_DRAW_OFFLINE" } ], "header": "base/lcd.h", "name": "lcd_draw_mode_t", "prefix": "LCD_DRAW_", "level": 1 }, { "type": "enum", "desc": "LCD类型常量定义。", "consts": [ { "desc": "基于FrameBuffer的LCD。", "name": "LCD_FRAMEBUFFER" }, { "desc": "基于寄存器的LCD。", "name": "LCD_REGISTER" }, { "desc": "基于VGCANVS的LCD。仅在支持OpenGL时，用nanovg实现。", "name": "LCD_VGCANVAS" }, { "desc": "单色LCD。", "name": "LCD_MONO" } ], "header": "base/lcd.h", "name": "lcd_type_t", "prefix": "LCD_", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "rect_t*", "name": "dirty_rect", "desc": "需要绘制的区域。" }, { "type": "lcd_draw_mode_t", "name": "anim_mode", "desc": "动画模式，如果可能，直接画到显存而不是离线的framebuffer。" } ], "annotation": {}, "desc": "准备绘制。", "name": "lcd_begin_frame", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "rect_t*", "name": "rect", "desc": "裁剪区域。" } ], "annotation": {}, "desc": "设置裁剪区域。", "name": "lcd_set_clip_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "rect_t*", "name": "rect", "desc": "裁剪区域。" } ], "annotation": {}, "desc": "获取裁剪区域。", "name": "lcd_get_clip_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "wh_t", "name": "w", "desc": "新的宽度。" }, { "type": "wh_t", "name": "h", "desc": "新的高度。" }, { "type": "uint32_t", "name": "line_length", "desc": "line_length。" } ], "annotation": {}, "desc": "基于SDL的PC软件，在SDL窗口resize时，需要调用本函数resize lcd。\n屏幕旋转时会调用本函数，调整LCD的大小。", "name": "lcd_resize", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "uint8_t", "name": "alpha", "desc": "全局alpha。" } ], "annotation": {}, "desc": "设置全局alpha。", "name": "lcd_set_global_alpha", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "color_t", "name": "color", "desc": "颜色。" } ], "annotation": {}, "desc": "设置文本颜色。", "name": "lcd_set_text_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "color_t", "name": "color", "desc": "颜色。" } ], "annotation": {}, "desc": "设置线条颜色。", "name": "lcd_set_stroke_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "color_t", "name": "color", "desc": "颜色。" } ], "annotation": {}, "desc": "设置填充颜色。", "name": "lcd_set_fill_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "const char*", "name": "name", "desc": "字体名称。" } ], "annotation": {}, "desc": "设置字体名称。", "name": "lcd_set_font_name", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "uint32_t", "name": "font_size", "desc": "字体大小。" } ], "annotation": {}, "desc": "设置字体大小。", "name": "lcd_set_font_size", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" }, { "type": "xy_t", "name": "h", "desc": "直线高度。" } ], "annotation": {}, "desc": "绘制一条垂直线。", "name": "lcd_draw_vline", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" }, { "type": "xy_t", "name": "w", "desc": "直线宽度。" } ], "annotation": {}, "desc": "绘制一条水平线。", "name": "lcd_draw_hline", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "point_t*", "name": "points", "desc": "要绘制的点集合。" }, { "type": "uint32_t", "name": "nr", "desc": "点的个数。" } ], "annotation": {}, "desc": "绘制一组点。", "name": "lcd_draw_points", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" } ], "annotation": {}, "desc": "获取指定点的颜色，对于基于非FrameBuffer的LCD，返回当前的fill_color。", "name": "lcd_get_point_color", "return": { "type": "color_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" }, { "type": "wh_t", "name": "w", "desc": "宽度。" }, { "type": "wh_t", "name": "h", "desc": "高度。" } ], "annotation": {}, "desc": "绘制实心矩形。", "name": "lcd_fill_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" }, { "type": "wh_t", "name": "w", "desc": "宽度。" }, { "type": "wh_t", "name": "h", "desc": "高度。" } ], "annotation": {}, "desc": "绘制矩形。", "name": "lcd_stroke_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "glyph_t*", "name": "glyph", "desc": "字模" }, { "type": "rect_t*", "name": "src", "desc": "只绘制指定区域的部分。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" } ], "annotation": {}, "desc": "绘制字符。如果实现了measure_text/draw_text则不需要实现本函数。", "name": "lcd_draw_glyph", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "const wchar_t*", "name": "str", "desc": "字符串。" }, { "type": "uint32_t", "name": "nr", "desc": "字符数。" } ], "annotation": {}, "desc": "测量字符串占用的宽度。", "name": "lcd_measure_text", "return": { "type": "float_t", "desc": "返回字符串占用的宽度。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "const wchar_t*", "name": "str", "desc": "字符串。" }, { "type": "uint32_t", "name": "nr", "desc": "字符数。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" } ], "annotation": {}, "desc": "绘制字符。", "name": "lcd_draw_text", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "bitmap_t*", "name": "img", "desc": "图片。" }, { "type": "rect_t*", "name": "src", "desc": "只绘制指定区域的部分。" }, { "type": "rect_t*", "name": "dst", "desc": "绘制到目标区域。" } ], "annotation": {}, "desc": "绘制图片。", "name": "lcd_draw_image", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "draw_image_info_t*", "name": "info", "desc": "绘制参数。" } ], "annotation": {}, "desc": "绘制图片。", "name": "lcd_draw_image_matrix", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" } ], "annotation": {}, "desc": "获取矢量图canvas。", "name": "lcd_get_vgcanvas", "return": { "type": "vgcanvas_t*", "desc": "返回矢量图canvas。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "bitmap_t*", "name": "img", "desc": "返回快照图片。" }, { "type": "bool_t", "name": "auto_rotate", "desc": "是否根据LCD实际方向自动旋转。" } ], "annotation": {}, "desc": "拍摄快照，一般用于窗口动画，只有framebuffer模式，才支持。", "name": "lcd_take_snapshot", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" } ], "annotation": {}, "desc": "获取期望的位图格式。绘制期望的位图格式可以提高绘制性能。", "name": "lcd_get_desired_bitmap_format", "return": { "type": "bitmap_format_t", "desc": "返回期望的位图格式。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" } ], "annotation": {}, "desc": "获取宽度。", "name": "lcd_get_width", "return": { "type": "wh_t", "desc": "返回宽度。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" } ], "annotation": {}, "desc": "获取高度。", "name": "lcd_get_height", "return": { "type": "wh_t", "desc": "返回高度。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" } ], "annotation": {}, "desc": "判读lcd是否支持swap。", "name": "lcd_is_swappable", "return": { "type": "bool_t", "desc": "返回是否支持swap。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" } ], "annotation": {}, "desc": "完成绘制，同步到显示设备。", "name": "lcd_end_frame", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" }, { "type": "float_t*", "name": "ascent", "desc": "用于返回ascent。" }, { "type": "float_t*", "name": "descent", "desc": "用于返回descent。" }, { "type": "float_t*", "name": "line_hight", "desc": "用于返回line height。" } ], "annotation": {}, "desc": "获取当前字体的度量信息。", "name": "lcd_get_text_metrics", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "lcd_t*", "name": "lcd", "desc": "lcd对象。" } ], "annotation": {}, "desc": "销毁lcd对象。", "name": "lcd_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "w", "desc": "屏幕的宽度", "type": "wh_t", "annotation": { "readable": true } }, { "name": "height", "desc": "屏幕的高度", "type": "wh_t", "annotation": { "readable": true } }, { "name": "global_alpha", "desc": "全局alpha", "type": "uint8_t", "annotation": { "readable": true } }, { "name": "text_color", "desc": "文本颜色", "type": "color_t", "annotation": { "readable": true } }, { "name": "fill_color", "desc": "填充颜色", "type": "color_t", "annotation": { "readable": true } }, { "name": "stroke_color", "desc": "线条颜色", "type": "color_t", "annotation": { "readable": true } }, { "name": "font_name", "desc": "字体名称。", "type": "char*", "annotation": { "readable": true } }, { "name": "font_size", "desc": "字体大小。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "draw_mode", "desc": "绘制模式。", "type": "lcd_draw_mode_t", "annotation": { "readable": true } }, { "name": "type", "desc": "LCD的类型。", "type": "lcd_type_t", "annotation": { "readable": true } }, { "name": "ratio", "desc": "屏幕密度。", "type": "float_t", "annotation": { "readable": true } }, { "name": "support_dirty_rect", "desc": "是否支持脏矩形。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "last_update_time", "desc": "last update time", "type": "uint64_t", "annotation": { "readable": true } } ], "header": "base/lcd.h", "desc": "显示设备抽象基类。", "name": "lcd_t", "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true, "scriptable": true }, "desc": "获取缺省locale_info。", "name": "locale_info", "alias": "locale_info_instance", "return": { "type": "locale_info_t*", "desc": "返回locale_info对象。" } }, { "params": [ { "type": "locale_info_t*", "name": "locale_info", "desc": "locale_info对象。" } ], "annotation": {}, "desc": "设置缺省locale_info。", "name": "locale_info_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "char*", "name": "language", "desc": "语言。" }, { "type": "char*", "name": "country", "desc": "国家或地区。" } ], "annotation": { "constructor": true }, "desc": "创建locale_info。", "name": "locale_info_create", "return": { "type": "locale_info_t*", "desc": "返回locale_info对象。" } }, { "params": [ { "type": "locale_info_t*", "name": "locale_info", "desc": "locale_info对象。" }, { "type": "const char*", "name": "text", "desc": "待翻译的文本。" } ], "annotation": { "scriptable": true }, "desc": "翻译字符串。", "name": "locale_info_tr", "return": { "type": "const char*", "desc": "返回翻译之后的字符串。" } }, { "params": [ { "type": "locale_info_t*", "name": "locale_info", "desc": "locale_info对象。" }, { "type": "char*", "name": "language", "desc": "语言。" }, { "type": "char*", "name": "country", "desc": "国家或地区。" } ], "annotation": { "scriptable": true }, "desc": "设置当前的国家和语言。", "name": "locale_info_change", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "locale_info_t*", "name": "locale_info", "desc": "locale_info对象。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型，目前固定为EVT_LOCALE_CHANGED。" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": {}, "desc": "注册指定事件的处理函数。", "name": "locale_info_on", "return": { "type": "uint32_t", "desc": "返回id，用于locale_info_off。" } }, { "params": [ { "type": "locale_info_t*", "name": "locale_info", "desc": "locale_info对象。" }, { "type": "uint32_t", "name": "id", "desc": "locale_info_on返回的ID。" } ], "annotation": { "scriptable": true }, "desc": "注销指定事件的处理函数。", "name": "locale_info_off", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "locale_info_t*", "name": "locale_info", "desc": "locale_info对象。" }, { "type": "assets_manager_t*", "name": "assets_manager", "desc": "资源管理器。" } ], "annotation": {}, "desc": "设置资源管理器对象。", "name": "locale_info_set_assets_manager", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "locale_info_t*", "name": "locale_info", "desc": "locale_info对象。" } ], "annotation": {}, "desc": "重新加载字符串资源。", "name": "locale_info_reload", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "locale_info_t*", "name": "locale_info", "desc": "locale_info对象。" } ], "annotation": {}, "desc": "释放全部资源并销毁locale_info对象。", "name": "locale_info_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "country;", "desc": "国家或地区。如：CN", "type": "char*", "annotation": { "readable": true } }, { "name": "language", "desc": "语言。如：zh", "type": "char*", "annotation": { "readable": true } }, { "name": "assets_manager", "desc": "资源管理器。", "type": "assets_manager_t*", "annotation": { "private": true } } ], "header": "base/locale_info.h", "desc": "本地化信息。提供字符串翻译数据管理，当前语言改变的事件通知等等。", "name": "locale_info_t", "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "static": true }, "desc": "获取当前main_loop对象", "name": "main_loop", "return": { "type": "main_loop_t*", "desc": "返回main_loop对象。" } }, { "params": [ { "type": "main_loop_t*", "name": "l", "desc": "main_loop对象。" }, { "type": "event_source_t*", "name": "source", "desc": "event_source对象。" } ], "annotation": {}, "desc": "添加event_source。", "name": "main_loop_add_event_source", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "main_loop_t*", "name": "l", "desc": "main_loop对象。" }, { "type": "event_source_t*", "name": "source", "desc": "event_source对象。" } ], "annotation": {}, "desc": "删除event_source。", "name": "main_loop_remove_event_source", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/main_loop.h", "desc": "主循环接口。", "name": "main_loop_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "uint32_t", "name": "capacity", "desc": "初始容量。" } ], "annotation": { "constructor": true }, "desc": "初始化字符串对象。", "name": "wstr_init", "return": { "type": "wstr_t*", "desc": "str对象本身。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "wchar_t*", "name": "text", "desc": "要设置的字符串。" } ], "annotation": {}, "desc": "设置字符串。", "name": "wstr_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" } ], "annotation": {}, "desc": "清除字符串内容。", "name": "wstr_clear", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "char*", "name": "text", "desc": "要设置的字符串。" } ], "annotation": {}, "desc": "设置UTF8字符串。", "name": "wstr_set_utf8", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "char*", "name": "text", "desc": "返回的字符串。" }, { "type": "uint32_t", "name": "size", "desc": "text最大长度。" } ], "annotation": {}, "desc": "获取UTF8字符串。", "name": "wstr_get_utf8", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "uint32_t", "name": "offset", "desc": "指定的位置。" }, { "type": "uint32_t", "name": "nr", "desc": "要删除的字符数。" } ], "annotation": {}, "desc": "删除指定范围的字符。", "name": "wstr_remove", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "uint32_t", "name": "offset", "desc": "指定的位置。" }, { "type": "wchar_t*", "name": "text", "desc": "待插入的文本。" }, { "type": "uint32_t", "name": "nr", "desc": "要插入的字符数。" } ], "annotation": {}, "desc": "在指定位置插入字符串。", "name": "wstr_insert", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "wchar_t*", "name": "text", "desc": "要追加的字符串。" } ], "annotation": {}, "desc": "追加字符串。", "name": "wstr_append", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "wchar_t*", "name": "text", "desc": "要追加的字符串。" }, { "type": "uint32_t", "name": "len", "desc": "字符串长度。" } ], "annotation": {}, "desc": "追加字符串。", "name": "wstr_append_with_len", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "wchar_t", "name": "c", "desc": "字符。" } ], "annotation": {}, "desc": "追加一个字符。", "name": "wstr_push", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" } ], "annotation": {}, "desc": "删除尾部字符。", "name": "wstr_pop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "const char*", "name": "format", "desc": "格式(用于snprintf格式化数值)" }, { "type": "int32_t", "name": "value", "desc": "数值。" } ], "annotation": {}, "desc": "追加一个整数。", "name": "wstr_push_int", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "wstr_t*", "name": "other", "desc": "str对象。" } ], "annotation": {}, "desc": "判断两个字符是否相同。", "name": "wstr_equal", "return": { "type": "bool_t", "desc": "返回TRUE表示相同，否则表示不同。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "int32_t", "name": "v", "desc": "整数。" } ], "annotation": {}, "desc": "用整数初始化字符串。", "name": "wstr_from_int", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "double", "name": "v", "desc": "浮点数。" } ], "annotation": {}, "desc": "用浮点数初始化字符串。", "name": "wstr_from_float", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "value_t", "name": "v", "desc": "value。" } ], "annotation": {}, "desc": "用value初始化字符串。", "name": "wstr_from_value", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "int32_t*", "name": "v", "desc": "用于返回整数。" } ], "annotation": {}, "desc": "将字符串转成整数。", "name": "wstr_to_int", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "double*", "name": "v", "desc": "用于返回浮点数。" } ], "annotation": {}, "desc": "将字符串转成浮点数。", "name": "wstr_to_float", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "double", "name": "delta", "desc": "要加上的值。" } ], "annotation": {}, "desc": "将字符串转成浮点数，加上delta，再转换回来。", "name": "wstr_add_float", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" } ], "annotation": {}, "desc": "去掉浮点数小数点尾部的零。", "name": "wstr_trim_float_zero", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" }, { "type": "wchar_t", "name": "newline", "desc": "换行符。" } ], "annotation": {}, "desc": "规范化换行符。", "name": "wstr_normalize_newline", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "wstr_t*", "name": "str", "desc": "str对象。" } ], "annotation": {}, "desc": "重置字符串为空。", "name": "wstr_reset", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "size", "desc": "长度。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "capacity", "desc": "容量。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "str", "desc": "字符串。", "type": "wchar_t*", "annotation": { "readable": true } } ], "header": "tkc/wstr.h", "desc": "可变长度的宽字符字符串。\n\n示例：\n\n```c\nwstr_t s;\nwstr_init(&s, 0);\n\nwstr_append(&s, L\"abc\");\nwstr_append(&s, L\"123\");\n\nwstr_reset(&s);\n```\n> 先调wstr\\_init进行初始化，最后调用wstr\\_reset释放内存。", "name": "wstr_t", "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true }, "desc": "获取缺省的控件自身布局算法工厂对象。", "name": "self_layouter_factory", "return": { "type": "self_layouter_factory_t*", "desc": "返回控件自身布局算法工厂对象。" } }, { "params": [ { "type": "self_layouter_factory_t*", "name": "factory", "desc": "控件自身布局算法工厂对象。" } ], "annotation": {}, "desc": "设置缺省的控件自身布局算法工厂对象。", "name": "self_layouter_factory_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "constructor": true }, "desc": "创建控件自身布局算法工厂对象。", "name": "self_layouter_factory_create", "return": { "type": "self_layouter_factory_t*", "desc": "返回控件自身布局算法工厂对象。" } }, { "params": [ { "type": "self_layouter_factory_t*", "name": "factory", "desc": "layouter工厂对象。" }, { "type": "const char*", "name": "type", "desc": "控件自身布局算法类型。" }, { "type": "self_layouter_create_t", "name": "create", "desc": "控件自身布局算法创建函数。" } ], "annotation": {}, "desc": "注册控件自身布局算法创建函数。", "name": "self_layouter_factory_register", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "self_layouter_factory_t*", "name": "factory", "desc": "控件自身布局算法工厂对象。" }, { "type": "const char*", "name": "type", "desc": "类型。" } ], "annotation": { "constructor": true }, "desc": "创建指定类型的控件自身布局算法对象。", "name": "self_layouter_factory_create_layouter", "return": { "type": "self_layouter_t*", "desc": "返回控件自身布局算法对象。" } }, { "params": [ { "type": "self_layouter_factory_t*", "name": "factory", "desc": "控件自身布局算法工厂对象。" } ], "annotation": {}, "desc": "析构并释放控件自身布局算法工厂对象。", "name": "self_layouter_factory_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/self_layouter_factory.h", "desc": "控件自身布局算法工厂。", "name": "self_layouter_factory_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "self_layouter_t*", "name": "layouter", "desc": "layouter对象。" } ], "annotation": {}, "desc": "获取全部参数。", "name": "self_layouter_to_string", "return": { "type": "ret_t", "desc": "返回字符串格式的参数。" } }, { "params": [ { "type": "self_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "widget_t*", "name": "widget", "desc": "控件。" }, { "type": "rect_t*", "name": "area", "desc": "可以使用的区域。" } ], "annotation": {}, "desc": "对控件自身进行布局。", "name": "self_layouter_layout", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "self_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "const char*", "name": "name", "desc": "参数名。" }, { "type": "value_t*", "name": "v", "desc": "返回参数的值。" } ], "annotation": {}, "desc": "获取指定的参数。", "name": "self_layouter_get_param", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "self_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "const char*", "name": "name", "desc": "参数名。" }, { "type": "const value_t*", "name": "v", "desc": "参数的值。" } ], "annotation": {}, "desc": "获取指定的参数。", "name": "self_layouter_set_param", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "self_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "const char*", "name": "name", "desc": "参数名。" }, { "type": "const char*", "name": "value", "desc": "参数值。" } ], "annotation": {}, "desc": "设置字符串格式的参数。", "name": "self_layouter_set_param_str", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "self_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "const char*", "name": "name", "desc": "参数名。" }, { "type": "float_t", "name": "defval", "desc": "缺省值。" } ], "annotation": {}, "desc": "获取指定的浮点格式的参数。", "name": "self_layouter_get_param_float", "return": { "type": "ret_t", "desc": "成功返回参数的值，失败返回缺省值。" } }, { "params": [ { "type": "self_layouter_t*", "name": "layouter", "desc": "layouter对象。" }, { "type": "const char*", "name": "name", "desc": "参数名。" }, { "type": "int32_t", "name": "defval", "desc": "缺省值。" } ], "annotation": {}, "desc": "获取指定的整数格式的参数。", "name": "self_layouter_get_param_int", "return": { "type": "ret_t", "desc": "成功返回参数的值，失败返回缺省值。" } }, { "params": [ { "type": "self_layouter_t*", "name": "layouter", "desc": "layouter对象。" } ], "annotation": {}, "desc": "销毁layouter对象。", "name": "self_layouter_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "const char*", "name": "params", "desc": "参数。" } ], "annotation": {}, "desc": "创建layouter对象。", "name": "self_layouter_create", "return": { "type": "self_layouter_t*", "desc": "返回layouter对象。" } }, { "params": [ { "type": "const char*", "name": "layouter", "desc": "被克隆的对象。" } ], "annotation": {}, "desc": "克隆layouter对象。", "name": "self_layouter_clone", "return": { "type": "self_layouter_t*", "desc": "返回layouter对象。" } } ], "events": [], "properties": [], "header": "base/self_layouter.h", "desc": "控件自身排版布局器的接口。\n\n按特定算法对控件进行排版布局，子类需要实现vtable中的函数。", "name": "self_layouter_t", "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true }, "desc": "初始化快捷键对象。", "name": "shortcut_init", "return": { "type": "shortcut_t*", "desc": "返回快捷键对象。" } }, { "params": [ { "type": "shortcut_t*", "name": "shortcut", "desc": "快捷键对象。" } ], "annotation": { "constructor": true }, "desc": "初始化快捷键对象。", "name": "shortcut_init_with_str", "return": { "type": "shortcut_t*", "desc": "返回快捷键对象。" } }, { "params": [ { "type": "shortcut_t*", "name": "shortcut1", "desc": "快捷键对象1。" }, { "type": "shortcut_t*", "name": "shortcut2", "desc": "快捷键对象2。" } ], "annotation": {}, "desc": "比较两个快捷键对象。", "name": "shortcut_equal", "return": { "type": "bool_t", "desc": "返回TRUE表示相同，否则表示不同。" } }, { "params": [ { "type": "shortcut_t*", "name": "filter", "desc": "过滤器快捷键对象。" }, { "type": "shortcut_t*", "name": "event", "desc": "事件快捷键对象。" } ], "annotation": {}, "desc": "检查事件与快捷键是否匹配。", "name": "shortcut_match", "return": { "type": "bool_t", "desc": "返回TRUE表示匹配，否则表示不匹配。" } } ], "events": [], "properties": [ { "name": "is_valid", "desc": "是否有效。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "key", "desc": "键值。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "alt", "desc": "alt键是否按下。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "lalt", "desc": "left alt键是否按下。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "ralt", "desc": "right alt键是否按下。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "ctrl", "desc": "ctrl键是否按下。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "lctrl", "desc": "left ctrl键是否按下。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "rctrl", "desc": "right ctrl键是否按下。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "shift", "desc": "shift键是否按下。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "lshift", "desc": "left shift键是否按下。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "rshift", "desc": "right shift键是否按下。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "cmd", "desc": "cmd/win键是否按下。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "menu", "desc": "menu键是否按下。", "type": "bool_t", "annotation": { "readable": true } } ], "header": "base/shortcut.h", "desc": "快捷键。", "name": "shortcut_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "uint32_t", "name": "capacity", "desc": "容量。" }, { "type": "uint32_t", "name": "block_size", "desc": "块的大小。" } ], "annotation": { "constructor": true }, "desc": "创建waitable_ring_buffer对象。", "name": "waitable_ring_buffer_create", "return": { "type": "waitable_ring_buffer_t*", "desc": "waitable_ring_buffer对象。" } }, { "params": [ { "type": "waitable_ring_buffer_t*", "name": "rb", "desc": "waitable_ring_buffer对象。" }, { "type": "void*", "name": "buff", "desc": "接收数据的buff。" }, { "type": "uint32_t", "name": "size", "desc": "读取数据的长度(必须等于 block_size)。" }, { "type": "uint32_t", "name": "timeout_ms", "desc": "超时时间(ms)" } ], "annotation": {}, "desc": "读取数据。", "name": "waitable_ring_buffer_read", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "waitable_ring_buffer_t*", "name": "rb", "desc": "waitable_ring_buffer对象。" }, { "type": "const void*", "name": "buff", "desc": "要写入的数据。" }, { "type": "uint32_t", "name": "size", "desc": "数据的长度(必须等于 block_size)。" }, { "type": "uint32_t", "name": "timeout_ms", "desc": "超时时间(ms)" } ], "annotation": {}, "desc": "写入数据。", "name": "waitable_ring_buffer_write", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "waitable_ring_buffer_t*", "name": "rb", "desc": "waitable_ring_buffer对象。" } ], "annotation": {}, "desc": "销毁。", "name": "waitable_ring_buffer_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "tkc/waitable_ring_buffer.h", "desc": "waitable ring buffer", "name": "waitable_ring_buffer_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "style_factory_t*", "name": "factory", "desc": "factory对象。" }, { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "创建style。", "name": "style_factory_create_style", "return": { "type": "style_t*", "desc": "返回style对象。" } }, { "params": [], "annotation": { "constructor": true }, "desc": "获取缺省的style factory。", "name": "style_factory", "alias": "style_factory_instance", "return": { "type": "style_factory_t*", "desc": "返回style factory对象。" } }, { "params": [ { "type": "style_factory_t*", "name": "factory", "desc": "factory对象。" } ], "annotation": {}, "desc": "设置缺省的style factory(需要自定义的style factory才设置)。", "name": "style_factory_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/style_factory.h", "desc": "style工厂接口，主要用于创建style。\n\n> 在特殊情况下，可以实现自己的style工厂，比如支持CSS和可实时修改的style。", "name": "style_factory_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "uint32_t", "name": "capacity", "desc": "action的容量。" } ], "annotation": { "constructor": true }, "desc": "创建waitable_action_queue对象。", "name": "waitable_action_queue_create", "return": { "type": "waitable_action_queue_t*", "desc": "waitable_action_queue对象。" } }, { "params": [ { "type": "waitable_action_queue_t*", "name": "q", "desc": "waitable_action_queue对象。" }, { "type": "qaction_t**", "name": "action", "desc": "用于返回action对象。" }, { "type": "uint32_t", "name": "timeout_ms", "desc": "超时时间(ms)" } ], "annotation": {}, "desc": "接收一个请求。", "name": "waitable_action_queue_recv", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "waitable_action_queue_t*", "name": "q", "desc": "waitable_action_queue对象。" }, { "type": "qaction_t*", "name": "action", "desc": "action对象。" }, { "type": "uint32_t", "name": "timeout_ms", "desc": "超时时间(ms)" } ], "annotation": {}, "desc": "发送一个请求。", "name": "waitable_action_queue_send", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "waitable_action_queue_t*", "name": "q", "desc": "waitable_action_queue对象。" } ], "annotation": {}, "desc": "销毁。", "name": "waitable_action_queue_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "tkc/waitable_action_queue.h", "desc": "waitable actionqueue", "name": "waitable_action_queue_t", "level": 1 }, { "type": "enum", "desc": "style常量定义。", "consts": [ { "desc": "背景颜色。", "name": "STYLE_ID_BG_COLOR" }, { "desc": "前景颜色。", "name": "STYLE_ID_FG_COLOR" }, { "desc": "蒙版颜色。", "name": "STYLE_ID_MASK_COLOR" }, { "desc": "字体名称。", "name": "STYLE_ID_FONT_NAME" }, { "desc": "字体大小。", "name": "STYLE_ID_FONT_SIZE" }, { "desc": "字体风格(粗体、斜体等)。", "name": "STYLE_ID_FONT_STYLE" }, { "desc": "文本颜色。", "name": "STYLE_ID_TEXT_COLOR" }, { "desc": "高亮文本的字体名称。", "name": "STYLE_ID_HIGHLIGHT_FONT_NAME" }, { "desc": "高亮文本的字体大小。", "name": "STYLE_ID_HIGHLIGHT_FONT_SIZE" }, { "desc": "高亮文本的文本颜色。", "name": "STYLE_ID_HIGHLIGHT_TEXT_COLOR" }, { "desc": "提示文本颜色。", "name": "STYLE_ID_TIPS_TEXT_COLOR" }, { "desc": "文本水平对齐的方式。", "name": "STYLE_ID_TEXT_ALIGN_H" }, { "desc": "文本垂直对齐的方式。", "name": "STYLE_ID_TEXT_ALIGN_V" }, { "desc": "边框颜色。", "name": "STYLE_ID_BORDER_COLOR" }, { "desc": "边框线宽。", "name": "STYLE_ID_BORDER_WIDTH" }, { "desc": "边框类型。", "name": "STYLE_ID_BORDER" }, { "desc": "图片的名称。", "name": "STYLE_ID_BG_IMAGE" }, { "desc": "图片的显示方式。", "name": "STYLE_ID_BG_IMAGE_DRAW_TYPE" }, { "desc": "图标的名称。", "name": "STYLE_ID_ICON" }, { "desc": "图片的名称。", "name": "STYLE_ID_FG_IMAGE" }, { "desc": "图片的显示方式。", "name": "STYLE_ID_FG_IMAGE_DRAW_TYPE" }, { "desc": "间距。", "name": "STYLE_ID_SPACER" }, { "desc": "边距。", "name": "STYLE_ID_MARGIN" }, { "desc": "左边距。", "name": "STYLE_ID_MARGIN_LEFT" }, { "desc": "右边距。", "name": "STYLE_ID_MARGIN_RIGHT" }, { "desc": "顶边距。", "name": "STYLE_ID_MARGIN_TOP" }, { "desc": "底边距。", "name": "STYLE_ID_MARGIN_BOTTOM" }, { "desc": "图标的位置。", "name": "STYLE_ID_ICON_AT" }, { "desc": "Active图标的名称。", "name": "STYLE_ID_ACTIVE_ICON" }, { "desc": "X方向的偏移，方便实现按下的效果。", "name": "STYLE_ID_X_OFFSET" }, { "desc": "Y方向的偏移，方便实现按下的效果。", "name": "STYLE_ID_Y_OFFSET" }, { "desc": "编辑器中选中区域的背景颜色。", "name": "STYLE_ID_SELECTED_BG_COLOR" }, { "desc": "编辑器中选中区域的前景颜色。", "name": "STYLE_ID_SELECTED_FG_COLOR" }, { "desc": "编辑器中选中区域的文本颜色。", "name": "STYLE_ID_SELECTED_TEXT_COLOR" }, { "desc": "圆角半径(仅在WITH_VGCANVAS定义时生效)。", "name": "STYLE_ID_ROUND_RADIUS" }, { "desc": "子控件布局参数。", "name": "STYLE_ID_CHILDREN_LAYOUT" }, { "desc": "控件布局参数。", "name": "STYLE_ID_SELF_LAYOUT" } ], "header": "base/style.h", "name": "style_id_t", "prefix": "STYLE", "annotation": { "scriptable": true, "string": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "widget状态改变时，通知style更新数据。", "name": "style_notify_widget_state_changed", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" } ], "annotation": { "scriptable": true }, "desc": "检查style对象是否有效", "name": "style_is_valid", "return": { "type": "bool_t", "desc": "返回是否有效。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "int32_t", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取指定name的整数格式的值。", "name": "style_get_int", "return": { "type": "int32_t", "desc": "返回整数格式的值。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "color_t", "name": "defval", "desc": "缺省值。" } ], "annotation": {}, "desc": "获取指定name的颜色值。", "name": "style_get_color", "return": { "type": "color_t", "desc": "返回颜色值。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "const char*", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取指定name的字符串格式的值。", "name": "style_get_str", "return": { "type": "const char*", "desc": "返回字符串格式的值。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "const char*", "name": "state", "desc": "状态。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "const value_t*", "name": "value", "desc": "值。" } ], "annotation": { "scriptable": true }, "desc": "设置指定状态的指定属性的值(仅仅对mutable的style有效)。", "name": "style_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" } ], "annotation": { "scriptable": true }, "desc": "检查style是否是mutable的。", "name": "style_is_mutable", "return": { "type": "bool_t", "desc": "返回TRUE表示是，否则表示不是。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" } ], "annotation": {}, "desc": "销毁style对象", "name": "style_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "const char*", "name": "name", "desc": "名称。" }, { "type": "const char*", "name": "value", "desc": "值。" }, { "type": "value_t*", "name": "out", "desc": "返回的值。" } ], "annotation": {}, "desc": "对值进行正规化。", "name": "style_normalize_value", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/style.h", "desc": "控件风格。\n\nwidget从style对象中，获取诸如字体、颜色和图片相关的参数，根据这些参数来绘制界面。\n\n```c\nstyle_t* style = widget->astyle;\nint32_t margin = style_get_int(style, STYLE_ID_MARGIN, 2);\nint32_t icon_at = style_get_int(style, STYLE_ID_ICON_AT, ICON_AT_AUTO);\nuint16_t font_size = style_get_int(style, STYLE_ID_FONT_SIZE, TK_DEFAULT_FONT_SIZE);\n```\n\n属性名称的请参考[style\\_id](style_id_t.md)", "name": "style_t", "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "asset_info_t*", "name": "res", "desc": "数据资源。" } ], "annotation": { "constructor": true }, "desc": "创建联想字对象。", "name": "suggest_words_create", "return": { "type": "suggest_words_t*", "desc": "返回联想字对象。" } }, { "params": [ { "type": "suggest_words_t*", "name": "suggest_words", "desc": "联想字对象。" }, { "type": "wchar_t", "name": "c", "desc": "字符。" } ], "annotation": {}, "desc": "查找prefix对应的联想字列表，成功后会更新words/words_nr。", "name": "suggest_words_find", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "suggest_words_t*", "name": "suggest_words", "desc": "联想字对象。" } ], "annotation": {}, "desc": "@deconstructor\n销毁联想字对象。", "name": "suggest_words_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "words", "desc": "联想字列表。find函数执行成功后会更新。", "type": "char*", "annotation": { "private": true } }, { "name": "words_nr", "desc": "联想字/词个数。find函数执行成功后会更新。", "type": "uint32_t", "annotation": { "private": true } } ], "header": "base/suggest_words.h", "desc": "输入法联想字词。", "name": "suggest_words_t", "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true, "scriptable": true }, "desc": "获取缺省资源管理器。", "name": "assets_manager", "alias": "assets_manager_instance", "return": { "type": "assets_manager_t*", "desc": "返回asset manager对象。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" } ], "annotation": {}, "desc": "设置缺省资源管理器。", "name": "assets_manager_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "uint32_t", "name": "init_nr", "desc": "预先分配资源的个数。" } ], "annotation": { "constructor": true }, "desc": "创建资源管理器。", "name": "assets_manager_create", "return": { "type": "assets_manager_t*", "desc": "返回asset manager对象。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "uint32_t", "name": "init_nr", "desc": "预先分配资源的个数。" } ], "annotation": { "constructor": true }, "desc": "初始化资源管理器。", "name": "assets_manager_init", "return": { "type": "assets_manager_t*", "desc": "返回asset manager对象。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "const char*", "name": "res_root", "desc": "资源所在的目录。" } ], "annotation": {}, "desc": "设置资源所在的目录(其下目录结构请参考demos)。", "name": "assets_manager_set_res_root", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "const char*", "name": "theme", "desc": "主题名称。" } ], "annotation": { "scriptable": true }, "desc": "设置当前的主题。", "name": "assets_manager_set_theme", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "system_info_t*", "name": "system_info", "desc": "system_info对象。。" } ], "annotation": {}, "desc": "设置system_info对象。", "name": "assets_manager_set_system_info", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "locale_info_t*", "name": "locale_info", "desc": "locale_info对象。。" } ], "annotation": {}, "desc": "设置locale_info对象。", "name": "assets_manager_set_locale_info", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "asset_info_t", "name": "info", "desc": "待增加的资源。" } ], "annotation": {}, "desc": "向资源管理器中增加一个资源。", "name": "assets_manager_add", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "const char*", "name": "name", "desc": "待增加的资源的名字。" }, { "type": "uint16_t", "name": "type", "desc": "待增加的资源的主类型枚举。" }, { "type": "uint16_t", "name": "subtype", "desc": "待增加的资源的子类型枚举。" }, { "type": "uint8_t*", "name": "buff", "desc": "待增加的资源的data数据。" }, { "type": "uint32_t", "name": "size", "desc": "待增加的资源的data数据长度。" } ], "annotation": {}, "desc": "向资源管理器中增加一个资源data。", "name": "assets_manager_add_data", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "asset_type_t", "name": "type", "desc": "资源的类型。" }, { "type": "char*", "name": "name", "desc": "资源的名称。" } ], "annotation": { "scriptable": true }, "desc": "在资源管理器的缓存中查找指定的资源并引用它，如果缓存中不存在，尝试加载该资源。", "name": "assets_manager_ref", "return": { "type": "asset_info_t*", "desc": "返回资源。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "asset_info_t*", "name": "info", "desc": "资源。" } ], "annotation": { "scriptable": true }, "desc": "释放指定的资源。", "name": "assets_manager_unref", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "asset_type_t", "name": "type", "desc": "资源的类型。" }, { "type": "char*", "name": "name", "desc": "资源的名称。" } ], "annotation": {}, "desc": "在资源管理器的缓存中查找指定的资源(不引用)。", "name": "assets_manager_find_in_cache", "return": { "type": "asset_info_t*", "desc": "返回资源。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "asset_type_t", "name": "type", "desc": "资源的类型。" }, { "type": "char*", "name": "name", "desc": "资源的名称。" } ], "annotation": {}, "desc": "从文件系统中加载指定的资源，并缓存到内存中。在定义了宏WITH\\_FS\\_RES时才生效。", "name": "assets_manager_load", "return": { "type": "asset_info_t*", "desc": "返回资源。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "asset_type_t", "name": "type", "desc": "资源的类型。" }, { "type": "char*", "name": "name", "desc": "资源的名称。" } ], "annotation": {}, "desc": "从文件系统中加载指定的资源，并缓存到内存中。在定义了宏WITH\\_FS\\_RES时才生效。", "name": "assets_manager_preload", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "asset_loader_t*", "name": "loader", "desc": "加载器(由assets manager销毁)。" } ], "annotation": {}, "desc": "设置loader。", "name": "assets_manager_set_loader", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "assets_manager_build_asset_dir_t", "name": "custom_build_asset_dir", "desc": "回调函数。" }, { "type": "void*", "name": "ctx", "desc": "回调函数的上下文。" } ], "annotation": {}, "desc": "设置一个函数，该函数用于生成资源路径。\n\n> 有时我们需要优先加载用户自定义的资源，加载失败才加载系统缺省的，可用设置一个函数去实现这类功能。", "name": "assets_manager_set_custom_build_asset_dir", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "assets_manager_load_asset_t", "name": "custom_load_asset", "desc": "回调函数。" }, { "type": "void*", "name": "ctx", "desc": "回调函数的上下文。" } ], "annotation": {}, "desc": "设置一个函数，该函数用于实现自定义加载资源。\n\n> 如果不支持文件系统，开发者可以设置一个加载资源的回调函数，从flash或其它地方读取资源。", "name": "assets_manager_set_custom_load_asset", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "asset_type_t", "name": "type", "desc": "资源的类型。" } ], "annotation": {}, "desc": "清除指定类型的缓存。", "name": "assets_manager_clear_cache", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" } ], "annotation": {}, "desc": "清除全部缓存的资源。", "name": "assets_manager_clear_all", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" } ], "annotation": {}, "desc": "释放全部资源。", "name": "assets_manager_deinit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" } ], "annotation": {}, "desc": "释放全部资源并销毁asset manager对象。", "name": "assets_manager_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "assets_manager_t*", "name": "am", "desc": "asset manager对象。" }, { "type": "asset_type_t", "name": "type", "desc": "资源类型。" }, { "type": "const char*", "name": "path", "desc": "目录。" } ], "annotation": {}, "desc": "获取path里的资源。", "name": "assets_manager_load_file", "return": { "type": "asset_info_t*", "desc": "返回asset_info_t。" } } ], "events": [], "properties": [], "header": "base/assets_manager.h", "desc": "资源管理器。\n这里的资源管理器并非Windows下的文件浏览器，而是负责对各种资源，比如字体、主题、图片、界面数据、字符串和其它数据的进行集中管理的组件。引入资源管理器的目的有以下几个：\n\n* 让上层不需要了解存储的方式。\n在没有文件系统时或者内存紧缺时，把资源转成常量数组直接编译到代码中。在有文件系统而且内存充足时，资源放在文件系统中。在有网络时，资源也可以存放在服务器上(暂未实现)。资源管理器为上层提供统一的接口，让上层而不用关心底层的存储方式。\n\n* 让上层不需要了解资源的具体格式。\n比如一个名为earth的图片，没有文件系统或内存紧缺，图片直接用位图数据格式存在ROM中，而有文件系统时，则用PNG格式存放在文件系统中。资源管理器让上层不需要关心图片的格式，访问时指定图片的名称即可(不用指定扩展名)。\n\n* 让上层不需要了解屏幕的密度。\n不同的屏幕密度下需要加载不同的图片，比如MacPro的Retina屏就需要用双倍解析度的图片，否则就出现界面模糊。AWTK以后会支持PC软件和手机软件的开发，所以资源管理器需要为此提供支持，让上层不需关心屏幕的密度。\n\n* 对资源进行内存缓存。\n不同类型的资源使用方式是不一样的，比如字体和主题加载之后会一直使用，UI文件在生成界面之后就暂时不需要了，PNG文件解码之后就只需要保留解码的位图数据即可。资源管理器配合图片管理器等其它组件实现资源的自动缓存。\n\n当从文件系统加载资源时，目录结构要求如下：\n\n```\nassets/{theme}/raw/\nfonts 字体\nimages 图片\nx1 普通密度屏幕的图片。\nx2 2倍密度屏幕的图片。\nx3 3倍密度屏幕的图片。\nxx 密度无关的图片。\nstrings 需要翻译的字符串。\nstyles 主题数据。\nui UI描述数据。\n```", "name": "assets_manager_t", "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [], "events": [], "properties": [], "header": "base/text_edit.h", "desc": "", "name": "text_edit_state_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件" }, { "type": "boo_t", "name": "single_line", "desc": "是否是单行编辑器。" } ], "annotation": {}, "desc": "创建text_edit对象", "name": "text_edit_create", "return": { "type": "widget_t*", "desc": "对象。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "canvas_t*", "name": "c", "desc": "canvas对象。" } ], "annotation": {}, "desc": "设置canvas对象。", "name": "text_edit_set_canvas", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" } ], "annotation": {}, "desc": "处理点击事件。", "name": "text_edit_click", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" } ], "annotation": {}, "desc": "处理拖动事件。", "name": "text_edit_drag", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "const wchar_t*", "name": "str", "desc": "文本。" }, { "type": "uint32_t", "name": "size", "desc": "文本长度。" } ], "annotation": {}, "desc": "粘贴文本。", "name": "text_edit_paste", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "剪切文本。", "name": "text_edit_cut", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "拷贝文本。", "name": "text_edit_copy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "key_event_t*", "name": "evt", "desc": "event" } ], "annotation": {}, "desc": "处理按键事件。", "name": "text_edit_key_down", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "key_event_t*", "name": "evt", "desc": "event" } ], "annotation": {}, "desc": "处理按键事件。", "name": "text_edit_key_up", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "uint32_t", "name": "start", "desc": "起始偏移。" }, { "type": "uint32_t", "name": "end", "desc": "结束偏移。" } ], "annotation": {}, "desc": "选择指定范围的文本。", "name": "text_edit_set_select", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "全选。", "name": "text_edit_select_all", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "取消选择。", "name": "text_edit_unselect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "uint32_t", "name": "cursor", "desc": "光标偏移。" } ], "annotation": {}, "desc": "设置光标位置。", "name": "text_edit_set_cursor", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "获取光标位置。", "name": "text_edit_get_cursor", "return": { "type": "uin32_t", "desc": "返回光标的位置。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "text_edit_state_t*", "name": "state", "desc": "状态。" } ], "annotation": {}, "desc": "获取编辑器的状态。", "name": "text_edit_get_state", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "bool_t", "name": "wrap_word", "desc": "是否自动折行。" } ], "annotation": {}, "desc": "设置是否自动折行。", "name": "text_edit_set_wrap_word", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "如果caret可见，将其设置为不可见。 如果caret不可见，将其设置为可见。", "name": "text_edit_invert_caret_visible", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "bool_t", "name": "caret_visible", "desc": "是否可见。" } ], "annotation": {}, "desc": "设置光标的看见性。", "name": "text_edit_set_caret_visible", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "uint32_t", "name": "max_rows", "desc": "最大行数。" } ], "annotation": {}, "desc": "设置最大行数。", "name": "text_edit_set_max_rows", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "bool_t", "name": "mask", "desc": "是否马赛克字符。" } ], "annotation": {}, "desc": "设置是否马赛克字符(用于密码)。", "name": "text_edit_set_mask", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "const char*", "name": "tips", "desc": "提示信息。" } ], "annotation": {}, "desc": "设置提示信息。", "name": "text_edit_set_tips", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "wchar_t", "name": "mask_char", "desc": "马赛克字符。" } ], "annotation": {}, "desc": "设置马赛克字符。", "name": "text_edit_set_mask_char", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "canvas_t*", "name": "c", "desc": "canvas对象。" } ], "annotation": {}, "desc": "绘制文本。", "name": "text_edit_paint", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "重新排版。", "name": "text_edit_layout", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "int32_t", "name": "ox", "desc": "x偏移量。" }, { "type": "int32_t", "name": "oy", "desc": "y偏移量。" } ], "annotation": {}, "desc": "设置滚动偏移。", "name": "text_edit_set_offset", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" }, { "type": "text_edit_on_state_changed_t", "name": "on_state_changed", "desc": "回调函数。" }, { "type": "void*", "name": "ctx", "desc": "回调函数上下文。" } ], "annotation": {}, "desc": "设置状态改变回调函数。", "name": "text_edit_set_on_state_changed", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "销毁text_edit对象。", "name": "text_edit_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "清除预编辑文本。", "name": "text_edit_preedit_clear", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "进入预编辑状态。", "name": "text_edit_preedit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "提交预编辑的文本，并退出预编辑状态。", "name": "text_edit_preedit_confirm", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "text_edit_t*", "name": "text_edit", "desc": "text_edit对象。" } ], "annotation": {}, "desc": "取消预编辑的文本，并退出预编辑状态。", "name": "text_edit_preedit_abort", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/text_edit.h", "desc": "", "name": "text_edit_t", "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true, "scriptable": true }, "desc": "获取缺省的主题对象。", "name": "theme", "alias": "theme_instance", "return": { "type": "theme_t*", "desc": "返回主题对象。" } }, { "params": [ { "type": "theme_t*", "name": "theme", "desc": "主题对象。" } ], "annotation": {}, "desc": "设置缺省的主题对象。", "name": "theme_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "const uint8_t*", "name": "data", "desc": "主题数据。" } ], "annotation": { "constructor": true }, "desc": "创建主题对象。", "name": "theme_create", "return": { "type": "theme_t*", "desc": "返回主题对象。" } }, { "params": [ { "type": "theme_t*", "name": "theme", "desc": "主题对象。" }, { "type": "const uint8_t*", "name": "data", "desc": "主题数据。" } ], "annotation": { "constructor": true }, "desc": "初始化主题对象。", "name": "theme_init", "return": { "type": "theme_t*", "desc": "返回主题对象。" } }, { "params": [ { "type": "theme_t*", "name": "data", "desc": "主题对象。" }, { "type": "const char*", "name": "widget_type", "desc": "控件的类型名。" }, { "type": "const char*", "name": "name", "desc": "style的名称。" }, { "type": "const char*", "name": "widget_state", "desc": "控件的状态。" } ], "annotation": {}, "desc": "查找满足条件的style。", "name": "theme_find_style", "return": { "type": "theme_t*", "desc": "返回主题对象。" } }, { "params": [ { "type": "theme_t*", "name": "theme", "desc": "主题对象。" } ], "annotation": {}, "desc": "析构主题对象。", "name": "theme_deinit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "theme_t*", "name": "theme", "desc": "主题对象。" } ], "annotation": {}, "desc": "析构并释放主题对象。", "name": "theme_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/theme.h", "desc": "主题。\n\n负责管理缺省的主题数据，方便实现style\\_const。", "name": "theme_t", "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "timer_func_t", "name": "on_timer", "desc": "timer回调函数。" }, { "type": "void*", "name": "ctx", "desc": "timer回调函数的上下文。" }, { "type": "uint32_t", "name": "duration", "desc": "时间。" } ], "annotation": { "scriptable": "custom", "static": true }, "desc": "增加一个timer。", "name": "timer_add", "return": { "type": "uint32_t", "desc": "返回timer的ID，TK_INVALID_ID表示失败。" } }, { "params": [ { "type": "timer_func_t", "name": "", "desc": "r" }, { "type": "void*", "name": "ctx", "desc": "timer回调函数的上下文。" }, { "type": "uint32_t", "name": "duration", "desc": "时间。" } ], "annotation": { "static": true }, "desc": "用于非GUI线程增加一个timer，本函数向主循环的事件队列中发送一个增加timer的请求。\ntimer回调函数，回调函数返回RET_REPEAT，则下次继续执行，否则自动移出。", "name": "timer_queue", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "uint32_t", "name": "timer_id", "desc": "timerID。" } ], "annotation": { "scriptable": true, "static": true }, "desc": "删除指定的timer。", "name": "timer_remove", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "uint32_t", "name": "timer_id", "desc": "timerID。" } ], "annotation": { "scriptable": true, "static": true }, "desc": "重置指定的timer，重置之后定时器重新开始计时。", "name": "timer_reset", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "uint32_t", "name": "timer_id", "desc": "timerID。" }, { "type": "uint32_t", "name": "duration", "desc": "新的时间。" } ], "annotation": { "scriptable": true, "static": true }, "desc": "修改指定的timer的duration，修改之后定时器重新开始计时。", "name": "timer_modify", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "uint32_t", "name": "timer_id", "desc": "timerID。" }, { "type": "tk_destroy_t", "name": "on_destroy", "desc": "回调函数。" }, { "type": "void*", "name": "on_destroy_ctx", "desc": "回调函数上下文。" } ], "annotation": {}, "desc": "设置一个回调函数，在timer被销毁时调用(方便脚本语言去释放回调函数)。", "name": "timer_set_on_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "static": true }, "desc": "返回timer的个数。", "name": "timer_count", "return": { "type": "uint32_t", "desc": "返回timer的个数。" } }, { "params": [], "annotation": { "static": true }, "desc": "返回最近的timer到期时间。", "name": "timer_next_time", "return": { "type": "uint32_t", "desc": "返回最近的timer到期时间。" } } ], "events": [], "properties": [], "header": "base/timer.h", "desc": "定时器系统。\n\n> 本定时器精度较低，最高精度为1000/FPS，如果需要高精度的定时器，请用OS提供的定时器。\n\n示例：\n\n```c\nstatic ret_t my_on_timer(const timer_info_t* info) {\nwidget_t* widget = WIDGET(info->ctx);\n...\nreturn RET_REPEAT;\n}\n\n...\n\ntimer_add(my_on_timer, widget, 1000);\n```\n> 在非GUI线程请用timer\\_queue。", "name": "timer_t", "annotation": { "scriptable": true, "fake": true }, "level": 1 }, { "type": "enum", "desc": "LCD旋转角度。", "consts": [ { "desc": "LCD没有旋转。", "name": "LCD_ORIENTATION_0" }, { "desc": "LCD旋转90度。", "name": "LCD_ORIENTATION_90" }, { "desc": "LCD旋转180度。", "name": "LCD_ORIENTATION_180" }, { "desc": "LCD旋转270度。", "name": "LCD_ORIENTATION_270" } ], "header": "base/types_def.h", "name": "lcd_orientation_t", "prefix": "LCD_ORIENTATION_", "level": 1 }, { "type": "enum", "desc": "垂直对齐的常量定义。", "consts": [ { "desc": "无效对齐方式。", "name": "ALIGN_V_NONE" }, { "desc": "居中对齐。", "name": "ALIGN_V_MIDDLE" }, { "desc": "顶部对齐。", "name": "ALIGN_V_TOP" }, { "desc": "底部对齐。", "name": "ALIGN_V_BOTTOM" } ], "header": "base/types_def.h", "name": "align_v_t", "prefix": "ALIGN_V_", "annotation": { "scriptable": true }, "level": 1 }, { "type": "enum", "desc": "水平对齐的常量定义。", "consts": [ { "desc": "无效对齐方式。", "name": "ALIGN_H_NONE" }, { "desc": "居中对齐。", "name": "ALIGN_H_CENTER" }, { "desc": "左边对齐。", "name": "ALIGN_H_LEFT" }, { "desc": "右边对齐。", "name": "ALIGN_H_RIGHT" } ], "header": "base/types_def.h", "name": "align_h_t", "prefix": "ALIGN_H_", "annotation": { "scriptable": true }, "level": 1 }, { "type": "enum", "desc": "控件边框类型。", "consts": [ { "desc": "无边框。", "name": "BORDER_NONE" }, { "desc": "左边框线。", "name": "BORDER_LEFT" }, { "desc": "右边框线。", "name": "BORDER_RIGHT" }, { "desc": "上边框线。", "name": "BORDER_TOP" }, { "desc": "下边框线。", "name": "BORDER_BOTTOM" }, { "desc": "全边框线。", "name": "BORDER_ALL" } ], "header": "base/types_def.h", "name": "border_type_t", "prefix": "BORDER_TYPE_", "level": 1 }, { "type": "enum", "desc": "图标所在的位置。", "consts": [ { "desc": "自动选择位置。", "name": "ICON_AT_AUTO" }, { "desc": "水平左边，垂直居中。", "name": "ICON_AT_LEFT" }, { "desc": "水平右边，垂直居中(not used now)。", "name": "ICON_AT_RIGHT" }, { "desc": "水平居中，垂直顶部(not used now)。", "name": "ICON_AT_TOP" }, { "desc": "水平居中，垂直低部(not used now)。", "name": "ICON_AT_BOTTOM" }, { "desc": "水平居中，垂直居中。", "name": "ICON_AT_CENTRE" } ], "header": "base/types_def.h", "name": "icon_at_type_t", "prefix": "ICON_AT", "level": 1 }, { "type": "enum", "desc": "应用程序类型。", "consts": [ { "desc": "嵌入式或移动APP", "name": "APP_MOBILE" }, { "desc": "模拟器。", "name": "APP_SIMULATOR" }, { "desc": "桌面应用程序。", "name": "APP_DESKTOP" } ], "header": "base/types_def.h", "name": "app_type_t", "prefix": "APP_", "annotation": { "scriptable": true }, "level": 1 }, { "type": "enum", "desc": "位图格式常量定义。", "consts": [ { "desc": "无效格式。", "name": "BITMAP_FMT_NONE" }, { "desc": "一个像素占用4个字节，RGBA占一个字节，按内存地址递增。", "name": "BITMAP_FMT_RGBA8888" }, { "desc": "一个像素占用4个字节，ABGR占一个字节，按内存地址递增。", "name": "BITMAP_FMT_ABGR8888" }, { "desc": "一个像素占用4个字节，BGRA占一个字节，按内存地址递增。", "name": "BITMAP_FMT_BGRA8888" }, { "desc": "一个像素占用4个字节，ARGB占一个字节，按内存地址递增。", "name": "BITMAP_FMT_ARGB8888" }, { "desc": "一个像素占用2个字节，RGB分别占用5,6,5位, 按内存地址递增。", "name": "BITMAP_FMT_RGB565" }, { "desc": "一个像素占用2个字节，BGR分别占用5,6,5位, 按内存地址递增。", "name": "BITMAP_FMT_BGR565" }, { "desc": "一个像素占用3个字节，RGB占一个字节，按内存地址递增。", "name": "BITMAP_FMT_RGB888" }, { "desc": "一个像素占用3个字节，RGB占一个字节，按内存地址递增。", "name": "BITMAP_FMT_BGR888" }, { "desc": "一个像素占用1个字节。", "name": "BITMAP_FMT_GRAY" }, { "desc": "一个像素占用1比特。", "name": "BITMAP_FMT_MONO" } ], "header": "base/types_def.h", "name": "bitmap_format_t", "prefix": "BITMAP_FMT_", "annotation": { "scriptable": true }, "level": 1 }, { "type": "enum", "desc": "位图标志常量定义。", "consts": [ { "desc": "无特殊标志。", "name": "BITMAP_FLAG_NONE" }, { "desc": "不透明图片。", "name": "BITMAP_FLAG_OPAQUE" }, { "desc": "图片内容不会变化。", "name": "BITMAP_FLAG_IMMUTABLE" }, { "desc": "OpenGL Texture, bitmap的id是有效的texture id。", "name": "BITMAP_FLAG_TEXTURE" }, { "desc": "如果是MUTABLE的图片，更新时需要设置此标志，底层可能会做特殊处理，比如更新图片到GPU。", "name": "BITMAP_FLAG_CHANGED" }, { "desc": "预乘alpha。", "name": "BITMAP_FLAG_PREMULTI_ALPHA" } ], "header": "base/types_def.h", "name": "bitmap_flag_t", "prefix": "BITMAP_FLAG_", "annotation": { "scriptable": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "ui_builder_t*", "name": "builder", "desc": "builder对象。" }, { "type": "const widget_desc_t*", "name": "desc", "desc": "widget描述信息。" } ], "annotation": {}, "desc": "ui\\_loader在解析到widget时，调用本函数进一步处理。", "name": "ui_builder_on_widget_start", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ui_builder_t*", "name": "builder", "desc": "builder对象。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "const char*", "name": "value", "desc": "属性值。" } ], "annotation": {}, "desc": "ui\\_loader在解析到widget的属性时，调用本函数进一步处理。", "name": "ui_builder_on_widget_prop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ui_builder_t*", "name": "builder", "desc": "builder对象。" } ], "annotation": {}, "desc": "ui\\_loader在解析到widget全部属性结束时，调用本函数进一步处理。", "name": "ui_builder_on_widget_prop_end", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ui_builder_t*", "name": "builder", "desc": "builder对象。" } ], "annotation": {}, "desc": "ui\\_loader在解析到widget结束时，调用本函数进一步处理。", "name": "ui_builder_on_widget_end", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ui_builder_t*", "name": "builder", "desc": "builder对象。" } ], "annotation": {}, "desc": "ui\\_loader在解析开始时，调用本函数做些准备工作。", "name": "ui_builder_on_start", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ui_builder_t*", "name": "builder", "desc": "builder对象。" } ], "annotation": {}, "desc": "ui\\_loader在解析结束时，调用本函数做些收尾工作。", "name": "ui_builder_on_end", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/ui_builder.h", "desc": "界面构造器接口。\n\n负责把ui\\_loader解析的数据进一步处理，至于具体做什么，由具体实现决定。常见的实现有：\n\n* 构建widget对象树。\n\n* 生成二进制的UI描述数据。\n\n* 生成XML格式的UI描述数据。\n\n```graphviz\n[default_style]\n\nui_builder_defualt_t -> ui_builder_t[arrowhead = \"empty\"]\nui_xml_writer_t -> ui_builder_t[arrowhead = \"empty\"]\nui_binary_writer_t -> ui_builder_t[arrowhead = \"empty\"]\n```", "name": "ui_builder_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "event_t*", "name": "evt", "desc": "event对象。" } ], "annotation": { "static": true }, "desc": "请求反馈。", "name": "ui_feedback_request", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "ui_on_feedback_t", "name": "on_feedback", "desc": "实际的处理函数。" }, { "type": "void*", "name": "ctx", "desc": "回调函数的上下文。" } ], "annotation": { "static": true }, "desc": "初始化。\n设置实际的处理函数。", "name": "ui_feedback_init", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/ui_feedback.h", "desc": "提供按键音、触屏音和震动等反馈。", "name": "ui_feedback_t", "annotation": { "fake": true }, "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "ui_loader_t*", "name": "loader", "desc": "loader对象。" }, { "type": "const uint8_t*", "name": "data", "desc": "数据。" }, { "type": "uint32_t", "name": "size", "desc": "数据长度。" }, { "type": "ui_builder_t*", "name": "builder", "desc": "负责进一步处理，比如构建UI界面。" } ], "annotation": {}, "desc": "加载界面描述数据，然后分发给ui\\_builder，由ui\\_builder进一步处理。", "name": "ui_loader_load", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "const char*", "name": "name", "desc": "资源名。" } ], "annotation": {}, "desc": "从指定的资源加载widget对象，通常用于加载非窗口的widget。\n\n>需要自己将widget加入窗口后，再调用widget\\_layout。", "name": "ui_loader_load_widget", "return": { "type": "widget_t*", "desc": "返回widget对象。" } } ], "events": [], "properties": [], "header": "base/ui_loader.h", "desc": "UI加载器。\n\n负责从资源加载界面描述数据，然后分发给ui\\_builder，由ui\\_builder进一步处理。\n\n常见的实现有两种：\n\n* XML格式的加载器。\n\n* 二进制格式的加载器。\n\n```graphviz\n[default_style]\n\nui_loader_defualt_t -> ui_loader_t[arrowhead = \"empty\"]\nui_loader_xml_t -> ui_loader_t[arrowhead = \"empty\"]\n\n```", "name": "ui_loader_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "velocity_t*", "name": "v", "desc": "velocity对象。" } ], "annotation": {}, "desc": "重置状态。", "name": "velocity_reset", "return": { "type": "velocity_t*", "desc": "返回velocity对象。" } }, { "params": [ { "type": "velocity_t*", "name": "v", "desc": "velocity对象。" }, { "type": "uint32_t", "name": "time", "desc": "时间。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" } ], "annotation": {}, "desc": "更新位置。", "name": "velocity_update", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/velocity.h", "desc": "velocity。", "name": "velocity_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "uint32_t", "name": "w", "desc": "宽度" }, { "type": "uint32_t", "name": "h", "desc": "高度" }, { "type": "uint32_t", "name": "stride", "desc": "一行占用的字节数。" }, { "type": "bitmap_format_t", "name": "format", "desc": "如果data是framebuffer，format指定data的格式。" }, { "type": "void*", "name": "data", "desc": "framebuffer或其它ctx。" } ], "annotation": { "constructor": true }, "desc": "创建vgcanvas。", "name": "vgcanvas_create", "return": { "type": "vgcanvas_t", "desc": "返回vgcanvas" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为vgcanvas对象(供脚本语言使用)。", "name": "vgcanvas_cast", "return": { "type": "vgcanvas_t*", "desc": "vgcanvas对象。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "uint32_t", "name": "w", "desc": "宽度" }, { "type": "uint32_t", "name": "h", "desc": "高度" }, { "type": "uint32_t", "name": "stride", "desc": "一行占用的字节数。" }, { "type": "bitmap_format_t", "name": "format", "desc": "如果data是framebuffer，format指定data的格式。" }, { "type": "void*", "name": "data", "desc": "framebuffer或其它ctx。" } ], "annotation": {}, "desc": "重新初始化，系统内部调用。", "name": "vgcanvas_reinit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": {}, "desc": "重置状态。", "name": "vgcanvas_reset", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": { "scriptable": true }, "desc": "flush", "name": "vgcanvas_flush", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "rect_t*", "name": "dirty_rect", "desc": "需要绘制的区域。" } ], "annotation": {}, "desc": "开始绘制，系统内部调用。", "name": "vgcanvas_begin_frame", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" }, { "type": "float_t", "name": "w", "desc": "宽度。" }, { "type": "float_t", "name": "h", "desc": "高度。" }, { "type": "color_t", "name": "c", "desc": "颜色。" } ], "annotation": {}, "desc": "用颜色清除指定矩形区域。", "name": "vgcanvas_clear_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": { "scriptable": true }, "desc": "清除之前的路径，并重新开始一条路径。", "name": "vgcanvas_begin_path", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" } ], "annotation": { "scriptable": true }, "desc": "移动当前点到指定点。", "name": "vgcanvas_move_to", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" } ], "annotation": { "scriptable": true }, "desc": "生成一条线段(从当前点到目标点)。", "name": "vgcanvas_line_to", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "cpx", "desc": "控制点x坐标。" }, { "type": "float_t", "name": "cpy", "desc": "控制点y坐标。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" } ], "annotation": { "scriptable": true }, "desc": "生成一条二次贝塞尔曲线。", "name": "vgcanvas_quad_to", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "cp1x", "desc": "控制点1x坐标。" }, { "type": "float_t", "name": "cp1y", "desc": "控制点1y坐标。" }, { "type": "float_t", "name": "cp2x", "desc": "控制点2x坐标。" }, { "type": "float_t", "name": "cp2y", "desc": "控制点3y坐标。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" } ], "annotation": { "scriptable": true }, "desc": "生成一条三次贝塞尔曲线。", "name": "vgcanvas_bezier_to", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x1", "desc": "起始点x坐标。" }, { "type": "float_t", "name": "y1", "desc": "起始点y坐标。" }, { "type": "float_t", "name": "x2", "desc": "结束点x坐标。" }, { "type": "float_t", "name": "y2", "desc": "结束点y坐标。" }, { "type": "float_t", "name": "r", "desc": "半径。" } ], "annotation": { "scriptable": true }, "desc": "生成一条圆弧路径到指定点。", "name": "vgcanvas_arc_to", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "原点x坐标。" }, { "type": "float_t", "name": "y", "desc": "原点y坐标。" }, { "type": "float_t", "name": "r", "desc": "半径。" }, { "type": "float_t", "name": "start_angle", "desc": "起始角度。" }, { "type": "float_t", "name": "end_angle", "desc": "结束角度。" }, { "type": "bool_t", "name": "ccw", "desc": "是否逆时针。" } ], "annotation": { "scriptable": true }, "desc": "生成一条圆弧。", "name": "vgcanvas_arc", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" } ], "annotation": { "scriptable": true }, "desc": "检查点是否在当前路径中。", "name": "vgcanvas_is_point_in_path", "return": { "type": "bool_t", "desc": "返回TRUE表示在，否则表示不在。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" }, { "type": "float_t", "name": "w", "desc": "宽度。" }, { "type": "float_t", "name": "h", "desc": "高度。" } ], "annotation": { "scriptable": true }, "desc": "生成一个矩形路径。", "name": "vgcanvas_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" }, { "type": "float_t", "name": "w", "desc": "宽度。" }, { "type": "float_t", "name": "h", "desc": "高度。" }, { "type": "float_t", "name": "r", "desc": "圆角半径。" } ], "annotation": { "scriptable": true }, "desc": "生成一个圆角矩形路径。", "name": "vgcanvas_rounded_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" }, { "type": "float_t", "name": "rx", "desc": "圆角半径。" }, { "type": "float_t", "name": "ry", "desc": "圆角半径。" } ], "annotation": { "scriptable": true }, "desc": "生成一个椭圆路径。", "name": "vgcanvas_ellipse", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": { "scriptable": true }, "desc": "闭合路径。\n\n>闭合路径是指把起点和终点连接起来，形成一个封闭的多边形。", "name": "vgcanvas_close_path", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "bool_t", "name": "dir", "desc": "填充方法。" } ], "annotation": { "scriptable": true }, "desc": "设置路径填充实心与否。\n\n>CCW(1)为实心，CW(2)为镂空，设置其他则默认根据非零环绕规则判断(nonzero)。", "name": "vgcanvas_path_winding", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "rad", "desc": "角度" } ], "annotation": { "scriptable": true }, "desc": "旋转。", "name": "vgcanvas_rotate", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x方向缩放比例。" }, { "type": "float_t", "name": "y", "desc": "y方向缩放比例。" } ], "annotation": { "scriptable": true }, "desc": "缩放。", "name": "vgcanvas_scale", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x方向偏移。" }, { "type": "float_t", "name": "y", "desc": "y方向偏移。" } ], "annotation": { "scriptable": true }, "desc": "平移。", "name": "vgcanvas_translate", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "a", "desc": "a" }, { "type": "float_t", "name": "b", "desc": "b" }, { "type": "float_t", "name": "c", "desc": "c" }, { "type": "float_t", "name": "d", "desc": "d" }, { "type": "float_t", "name": "e", "desc": "e" }, { "type": "float_t", "name": "f", "desc": "f" } ], "annotation": { "scriptable": true }, "desc": "变换矩阵。", "name": "vgcanvas_transform", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "a", "desc": "a" }, { "type": "float_t", "name": "b", "desc": "b" }, { "type": "float_t", "name": "c", "desc": "c" }, { "type": "float_t", "name": "d", "desc": "d" }, { "type": "float_t", "name": "e", "desc": "e" }, { "type": "float_t", "name": "f", "desc": "f" } ], "annotation": { "scriptable": true }, "desc": "设置变换矩阵。", "name": "vgcanvas_set_transform", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" }, { "type": "float_t", "name": "w", "desc": "宽度。" }, { "type": "float_t", "name": "h", "desc": "高度。" } ], "annotation": { "scriptable": true }, "desc": "矩形裁剪。", "name": "vgcanvas_clip_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" }, { "type": "float_t", "name": "w", "desc": "宽度。" }, { "type": "float_t", "name": "h", "desc": "高度。" } ], "annotation": { "scriptable": true }, "desc": "设置一个与前一个裁剪区做交集的矩形裁剪区。\n如果下面这种情况，则不能直接调用 rect_intersect 函数来做矩形交集和 vgcanvas_clip_rect 函数设置裁剪区，而采用本函数做交集。\n由于缩放和旋转以及平移会导致 vg 的坐标系和上一个裁剪区的坐标系不同，\n导致直接使用做交集的话，裁剪区会出错。\n\n```\nvgcanvas_clip_rect(vg, old_r.x, old_r.y, old_r.w, old_r.h);\nvgcanvas_save(vg);\nvgcanvas_scale(vg, scale_x, scale_y);\nvgcanvas_rotate(vg, TK_D2R(15));\nvgcanvas_intersect_clip_rect(vg, r.x, r.y, r.w, r.h);\n..................\nvgcanvas_restore(vg);\n```", "name": "vgcanvas_intersect_clip_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": { "scriptable": true }, "desc": "填充多边形。", "name": "vgcanvas_fill", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": { "scriptable": true }, "desc": "画线。", "name": "vgcanvas_stroke", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "bool_t", "name": "stroke", "desc": "TRUE表示画线FALSE表示填充。" }, { "type": "bitmap_t*", "name": "img", "desc": "图片。" } ], "annotation": { "scriptable": true }, "desc": "用图片填充/画多边形(可能存在可移植性问题，除非必要请勿使用)。\n多边形的顶点必须在图片范围内，可以通过矩阵变化画到不同的位置。", "name": "vgcanvas_paint", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "char*", "name": "font", "desc": "字体名称。" } ], "annotation": { "scriptable": true }, "desc": "设置字体的名称。", "name": "vgcanvas_set_font", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "font", "desc": "字体大小。" } ], "annotation": { "scriptable": true }, "desc": "设置字体的大小。", "name": "vgcanvas_set_font_size", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "char*", "name": "value", "desc": "取值：left|center|right，必须为常量字符串。" } ], "annotation": { "scriptable": true }, "desc": "设置文本水平对齐的方式。", "name": "vgcanvas_set_text_align", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "char*", "name": "value", "desc": "取值：top|middle|bottom，必须为常量字符串。" } ], "annotation": { "scriptable": true }, "desc": "设置文本垂直对齐的方式。", "name": "vgcanvas_set_text_baseline", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t*", "name": "ascent", "desc": "用于返回ascent。" }, { "type": "float_t*", "name": "descent", "desc": "用于返回descent。" }, { "type": "float_t*", "name": "line_hight", "desc": "用于返回line height。" } ], "annotation": {}, "desc": "获取当前字体的度量信息。", "name": "vgcanvas_get_text_metrics", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "char*", "name": "text", "desc": "text" }, { "type": "float_t", "name": "x", "desc": "x坐标。" }, { "type": "float_t", "name": "y", "desc": "y坐标。" }, { "type": "float_t", "name": "max_width", "desc": "最大宽度。" } ], "annotation": { "scriptable": true }, "desc": "绘制文本。", "name": "vgcanvas_fill_text", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "char*", "name": "text", "desc": "text" } ], "annotation": { "scriptable": true }, "desc": "测量文本的宽度。", "name": "vgcanvas_measure_text", "return": { "type": "float_t", "desc": "返回text的宽度。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "bitmap_t*", "name": "img", "desc": "图片。" }, { "type": "float_t", "name": "sx", "desc": "sx" }, { "type": "float_t", "name": "sy", "desc": "sy" }, { "type": "float_t", "name": "sw", "desc": "sw" }, { "type": "float_t", "name": "sh", "desc": "sh" }, { "type": "float_t", "name": "dx", "desc": "dx" }, { "type": "float_t", "name": "dy", "desc": "dy" }, { "type": "float_t", "name": "dw", "desc": "dw" }, { "type": "float_t", "name": "dh", "desc": "dh" } ], "annotation": { "scriptable": true }, "desc": "绘制图片。", "name": "vgcanvas_draw_image", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "bitmap_t*", "name": "img", "desc": "图片。" }, { "type": "float_t", "name": "sx", "desc": "sx" }, { "type": "float_t", "name": "sy", "desc": "sy" }, { "type": "float_t", "name": "sw", "desc": "sw" }, { "type": "float_t", "name": "sh", "desc": "sh" }, { "type": "float_t", "name": "dx", "desc": "dx" }, { "type": "float_t", "name": "dy", "desc": "dy" }, { "type": "float_t", "name": "dw", "desc": "dw" }, { "type": "float_t", "name": "dh", "desc": "dh" } ], "annotation": { "scriptable": true }, "desc": "绘制图标。\n\n绘制图标时会根据屏幕密度进行自动缩放，而绘制普通图片时不会。", "name": "vgcanvas_draw_icon", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "bool_t", "name": "value", "desc": "是否启用反走样。" } ], "annotation": { "scriptable": true }, "desc": "设置是否启用反走样。", "name": "vgcanvas_set_antialias", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "alpha", "desc": "global alpha。" } ], "annotation": { "scriptable": true }, "desc": "设置全局透明度。", "name": "vgcanvas_set_global_alpha", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "value", "desc": "线宽。" } ], "annotation": { "scriptable": true }, "desc": "设置线条的宽度。", "name": "vgcanvas_set_line_width", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "color_t", "name": "color", "desc": "颜色。" } ], "annotation": {}, "desc": "设置填充颜色。", "name": "vgcanvas_set_fill_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "const char*", "name": "color", "desc": "颜色。" } ], "annotation": { "scriptable": true }, "desc": "设置填充颜色。", "name": "vgcanvas_set_fill_color_str", "alias": "vgcanvas_set_fill_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "sx", "desc": "start x" }, { "type": "float_t", "name": "sy", "desc": "start y" }, { "type": "float_t", "name": "ex", "desc": "end x" }, { "type": "float_t", "name": "ey", "desc": "end y" }, { "type": "color_t", "name": "icolor", "desc": "开始颜色。" }, { "type": "color_t", "name": "ocolor", "desc": "结束颜色。" } ], "annotation": {}, "desc": "设置填充颜色为线性渐变色。", "name": "vgcanvas_set_fill_linear_gradient", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "cx", "desc": "center x" }, { "type": "float_t", "name": "cy", "desc": "center y" }, { "type": "float_t", "name": "inr", "desc": "内环半径" }, { "type": "float_t", "name": "outr", "desc": "外环半径。" }, { "type": "color_t", "name": "icolor", "desc": "开始颜色。" }, { "type": "color_t", "name": "ocolor", "desc": "结束颜色。" } ], "annotation": {}, "desc": "设置填充颜色为径向渐变色。", "name": "vgcanvas_set_fill_radial_gradient", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "color_t", "name": "color", "desc": "颜色。" } ], "annotation": {}, "desc": "设置线条颜色。", "name": "vgcanvas_set_stroke_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "const char*", "name": "color", "desc": "颜色。" } ], "annotation": { "scriptable": true }, "desc": "设置线条颜色。", "name": "vgcanvas_set_stroke_color_str", "alias": "vgcanvas_set_stroke_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "sx", "desc": "start x" }, { "type": "float_t", "name": "sy", "desc": "start y" }, { "type": "float_t", "name": "ex", "desc": "end x" }, { "type": "float_t", "name": "ey", "desc": "end y" }, { "type": "color_t", "name": "icolor", "desc": "开始颜色。" }, { "type": "color_t", "name": "ocolor", "desc": "结束颜色。" } ], "annotation": {}, "desc": "设置线条颜色为线性渐变色。", "name": "vgcanvas_set_stroke_linear_gradient", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "cx", "desc": "center x" }, { "type": "float_t", "name": "cy", "desc": "center y" }, { "type": "float_t", "name": "inr", "desc": "内环半径" }, { "type": "float_t", "name": "outr", "desc": "外环半径。" }, { "type": "color_t", "name": "icolor", "desc": "开始颜色。" }, { "type": "color_t", "name": "ocolor", "desc": "结束颜色。" } ], "annotation": {}, "desc": "设置线条颜色为径向渐变色。", "name": "vgcanvas_set_stroke_radial_gradient", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "char*", "name": "value", "desc": "取值：butt|round|square，必须为常量字符串。" } ], "annotation": { "scriptable": true }, "desc": "设置line cap。", "name": "vgcanvas_set_line_cap", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "char*", "name": "value", "desc": "取值：bevel|round|miter，必须为常量字符串。" } ], "annotation": { "scriptable": true }, "desc": "设置line join。", "name": "vgcanvas_set_line_join", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" }, { "type": "float_t", "name": "value", "desc": "miter limit" } ], "annotation": { "scriptable": true }, "desc": "设置miter limit。", "name": "vgcanvas_set_miter_limit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": { "scriptable": true }, "desc": "保存当前的状态。如颜色和矩阵等信息。\n\n> save/restore必须配套使用，否则可能导致状态混乱。", "name": "vgcanvas_save", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": { "scriptable": true }, "desc": "恢复上次save的状态。\n\n> save/restore必须配套使用，否则可能导致状态混乱。", "name": "vgcanvas_restore", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": {}, "desc": "结束绘制。系统内部调用。", "name": "vgcanvas_end_frame", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vgcanvas", "desc": "vgcanvas对象。" } ], "annotation": {}, "desc": "获取宽度。", "name": "vgcanvas_get_width", "return": { "type": "wh_t", "desc": "返回宽度。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vgcanvas", "desc": "vgcanvas对象。" } ], "annotation": {}, "desc": "获取高度。", "name": "vgcanvas_get_height", "return": { "type": "wh_t", "desc": "返回高度。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": {}, "desc": "释放vgcanvas对象的缓冲数据。", "name": "vgcanvas_clear_cache", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "vgcanvas_t*", "name": "vg", "desc": "vgcanvas对象。" } ], "annotation": {}, "desc": "销毁vgcanvas对象。", "name": "vgcanvas_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "w", "desc": "canvas的宽度", "type": "wh_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "h", "desc": "canvas的高度", "type": "wh_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "stride", "desc": "一行占的字节", "type": "uint32_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "ratio", "desc": "显示比例。", "type": "float_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "anti_alias", "desc": "是否启用反走样功能。", "type": "bool_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "line_width", "desc": "线宽。", "type": "float_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "global_alpha", "desc": "全局alpha。", "type": "float_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "miter_limit", "desc": "miter\\_limit。\n@see http://www.w3school.com.cn/tags/canvas_miterlimit.asp", "type": "float_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "line_cap", "desc": "line\\_cap。\n@see http://www.w3school.com.cn/tags/canvas_linecap.asp", "type": "const char*", "annotation": { "readable": true, "scriptable": true } }, { "name": "line_join", "desc": "line\\_join。\n@see http://www.w3school.com.cn/tags/canvas_linejoin.asp", "type": "const char*", "annotation": { "readable": true, "scriptable": true } }, { "name": "font", "desc": "字体。", "type": "char*", "annotation": { "readable": true, "scriptable": true } }, { "name": "font_size", "desc": "字体大小。", "type": "float_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "text_align", "desc": "文本对齐方式。\n\n@see http://www.w3school.com.cn/tags/canvas_textalign.asp", "type": "const char*", "annotation": { "readable": true, "scriptable": true } }, { "name": "text_baseline", "desc": "文本基线。\n\n@see http://www.w3school.com.cn/tags/canvas_textbaseline.asp", "type": "const char*", "annotation": { "readable": true, "scriptable": true } }, { "name": "fill_color", "desc": "填充颜色", "type": "color_t", "annotation": { "readable": true } }, { "name": "stroke_color", "desc": "线条颜色", "type": "color_t", "annotation": { "readable": true } }, { "name": "buff;", "desc": "frame buffer", "type": "uint32_t*", "annotation": { "private": true } }, { "name": "format;", "desc": "frame buffer format", "type": "bitmap_format_t", "annotation": { "private": true } } ], "header": "base/vgcanvas.h", "desc": "矢量图画布抽象基类。\n\n具体实现时可以使用agg，nanovg, cairo和skia等方式。\n\ncairo和skia体积太大，不适合嵌入式平台，但在PC平台也是一种选择。\n\n目前我们只提供了基于nanovg的实现，支持软件渲染和硬件渲染。\n\n我们对nanovg进行了一些改进:\n\n* 可以用agg/agge实现软件渲染(暂时不支持文本绘制)。\n\n* 可以用bgfx使用DirectX(Windows平台)和Metal(iOS)平台硬件加速。\n\n```graphviz\n[default_style]\n\nvgcanvas_cairo_t -> vgcanvas_t[arrowhead = \"empty\"]\nvgcanvas_nanovg_t -> vgcanvas_t[arrowhead = \"empty\"]\nopengl -> vgcanvas_nanovg_t[arrowhead = \"none\"]\nbgfx -> vgcanvas_nanovg_t[arrowhead = \"none\"]\nagg -> vgcanvas_nanovg_t[arrowhead = \"none\"]\nagge -> vgcanvas_nanovg_t[arrowhead = \"none\"]\nvgcanvas_skia_t -> vgcanvas_t[arrowhead = \"empty\"]\nvgcanvas_agge_t -> vgcanvas_t[arrowhead = \"empty\"]\n```\n\n示例：\n\n```c\nvgcanvas_t* vg = canvas_get_vgcanvas(c);\nvgcanvas_save(vg);\nvgcanvas_translate(vg, 0, 100);\n\nvgcanvas_set_line_width(vg, 1);\nvgcanvas_set_fill_color(vg, color_init(0xff, 0, 0, 0xff));\nvgcanvas_rect(vg, 5, 5, 100, 100);\nvgcanvas_fill(vg);\nvgcanvas_restore(vg);\n```\n\n>请参考：https://www.w3schools.com/tags/ref_canvas.asp", "name": "vgcanvas_t", "annotation": { "scriptable": true }, "level": 1 }, { "type": "enum", "desc": "线帽类型。", "consts": [ { "desc": "圆头。", "name": "VGCANVAS_LINE_CAP_ROUND" }, { "desc": "方头。", "name": "VGCANVAS_LINE_CAP_SQUARE" } ], "header": "base/vgcanvas.h", "name": "vgcanvas_line_cap_t", "prefix": "VGCANVAS_LINE_CAP_", "annotation": { "scriptable": true, "string": true }, "level": 1 }, { "type": "enum", "desc": "线条连接类型。", "consts": [ { "desc": "round。", "name": "VGCANVAS_LINE_JOIN_ROUND" }, { "desc": "bevel。", "name": "VGCANVAS_LINE_JOIN_BEVEL" }, { "desc": "mitter。", "name": "VGCANVAS_LINE_JOIN_MITTER" } ], "header": "base/vgcanvas.h", "name": "vgcanvas_line_join_t", "prefix": "VGCANVAS_LINE_JOIN_", "annotation": { "scriptable": true, "string": true }, "level": 1 }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "动画应用的控件。" }, { "type": "const char*", "name": "params", "desc": "参数。" } ], "annotation": { "global": true }, "desc": "创建animator对象。", "name": "widget_animator_create", "return": { "type": "widget_animator_t*", "desc": "动画对象。" }, "type": "method", "header": "base/widget_animator_factory.h", "level": 1 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true }, "desc": "获取缺省的控件动画管理器。", "name": "widget_animator_manager", "alias": "widget_animator_manager_instance", "return": { "type": "widget_animator_manager_t*", "desc": "返回控件动画管理器。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" } ], "annotation": {}, "desc": "设置缺省的控件动画管理器。", "name": "widget_animator_manager_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "constructor": true }, "desc": "创建控件动画管理器。", "name": "widget_animator_manager_create", "return": { "type": "widget_animator_manager_t*", "desc": "返回控件动画管理器。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" } ], "annotation": { "constructor": true }, "desc": "初始化控件动画管理器。", "name": "widget_animator_manager_init", "return": { "type": "widget_animator_manager_t*", "desc": "返回控件动画管理器。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" } ], "annotation": {}, "desc": "析构控件动画管理器。", "name": "widget_animator_manager_deinit", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" } ], "annotation": {}, "desc": "析构并释放控件动画管理器。", "name": "widget_animator_manager_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" }, { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" } ], "annotation": {}, "desc": "添加指定的动画，动画在创建时调用本函数。", "name": "widget_animator_manager_add", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" }, { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" } ], "annotation": {}, "desc": "移出指定的动画，动画在销毁时调用本函数。。", "name": "widget_animator_manager_remove", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" } ], "annotation": {}, "desc": "获取动画个数。", "name": "widget_animator_manager_count", "return": { "type": "ret_t", "desc": "返回动画个数。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" }, { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" } ], "annotation": {}, "desc": "播放满足条件的动画。\n1.widget为NULL时，播放所有名称为name的动画。\n2.name为NULL时，播放所有widget相关的动画。\n3.widget和name均为NULL，播放所有动画。", "name": "widget_animator_manager_start", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" }, { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" } ], "annotation": {}, "desc": "停止满足条件的动画。\n1.widget为NULL时，停止所有名称为name的动画。\n2.name为NULL时，停止所有widget相关的动画。\n3.widget和name均为NULL，停止所有动画。", "name": "widget_animator_manager_stop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" }, { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" } ], "annotation": {}, "desc": "暂停满足条件的动画。\n1.widget为NULL时，暂停所有名称为name的动画。\n2.name为NULL时，暂停所有widget相关的动画。\n3.widget和name均为NULL，暂停所有动画。", "name": "widget_animator_manager_pause", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" }, { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" } ], "annotation": {}, "desc": "查找满足条件的动画。", "name": "widget_animator_manager_find", "return": { "type": "widget_animator_t*", "desc": "成功返回动画对象，失败返回NULL。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" }, { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" } ], "annotation": {}, "desc": "销毁满足条件的动画。", "name": "widget_animator_manager_remove_all", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" }, { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" }, { "type": "float_t", "name": "time_scale", "desc": "时间倍率。" } ], "annotation": {}, "desc": "设置时间倍率。\n设置动画的时间倍率，<0: 时间倒退，<1: 时间变慢，>1 时间变快。", "name": "widget_animator_manager_set_time_scale", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_manager_t*", "name": "am", "desc": "控件动画管理器。" }, { "type": "uint32_t", "name": "delta_time", "desc": "流失的时间(毫秒)。" } ], "annotation": {}, "desc": "时间流失，调用本函数更新动画(public for test)。", "name": "widget_animator_manager_time_elapse", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "time_scale", "desc": "时间倍率，可以让时间变快或变慢。", "type": "float_t" } ], "header": "base/widget_animator_manager.h", "desc": "控件动画管理器。", "name": "widget_animator_manager_t", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" }, { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint32_t", "name": "duration", "desc": "动画持续时间。" }, { "type": "uint32_t", "name": "delay", "desc": "动画执行时间。" }, { "type": "easing_func_t", "name": "", "desc": "。" } ], "annotation": {}, "desc": "初始化。仅供子类内部使用。", "name": "widget_animator_init", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" }, { "type": "const char*", "name": "name", "desc": "名称。" } ], "annotation": {}, "desc": "设置名称。", "name": "widget_animator_set_name", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" }, { "type": "uint32_t", "name": "yoyo_times", "desc": "yoyo的次数，往返视为两次。" } ], "annotation": {}, "desc": "设置为yoyo模式。", "name": "widget_animator_set_yoyo", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" }, { "type": "uint32_t", "name": "repeat_times", "desc": "重复的次数。" } ], "annotation": {}, "desc": "设置为重复模式。", "name": "widget_animator_set_repeat", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" }, { "type": "bool_t", "name": "value", "desc": "是否为逆向模式。" } ], "annotation": {}, "desc": "设置为逆向模式。", "name": "widget_animator_set_reversed", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" }, { "type": "float_t", "name": "time_scale", "desc": "时间倍率。" } ], "annotation": {}, "desc": "设置时间倍率，用于实现时间加速减速和停滞的功能。", "name": "widget_animator_set_time_scale", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" }, { "type": "event_type_t", "name": "", "desc": "e" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": { "scriptable": "custom" }, "desc": "注册指定事件的处理函数。\n事件类型。目前支持：EVT_ANIM_START,EVT_ANIM_STOP,EVT_ANIM_PAUSE,EVT_ANIM_ONCE和EVT_ANIM_END。", "name": "widget_animator_on", "return": { "type": "uint32_t", "desc": "返回id，用于widget_animator_off。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" }, { "type": "uint32_t", "name": "id", "desc": "widget_animator_on返回的ID。" } ], "annotation": { "scriptable": "custom" }, "desc": "注销指定事件的处理函数。", "name": "widget_animator_off", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" } ], "annotation": {}, "desc": "启动动画。", "name": "widget_animator_start", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" } ], "annotation": {}, "desc": "停止动画。", "name": "widget_animator_stop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" } ], "annotation": {}, "desc": "暂停动画。", "name": "widget_animator_pause", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" }, { "type": "bool_t", "name": "destroy_when_done", "desc": "完成时是否自动销毁动画对象。" } ], "annotation": {}, "desc": "设置完成时是否自动销毁动画对象(缺省销毁)。", "name": "widget_animator_set_destroy_when_done", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_animator_t*", "name": "animator", "desc": "动画对象。" } ], "annotation": {}, "desc": "销毁animator对象。", "name": "widget_animator_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "name", "desc": "名称。", "type": "char*" }, { "name": "widget", "desc": "控件对象。", "type": "widget_t*", "annotation": { "private": true } }, { "name": "reversed", "desc": "逆向运行，在yoyo模式下自动设置。", "type": "bool_t", "annotation": { "private": true } }, { "name": "yoyo_times", "desc": "yoyo剩余次数。", "type": "uint32_t", "annotation": { "private": true } }, { "name": "repeat_times", "desc": "重复剩余次数。", "type": "uint32_t", "annotation": { "private": true } }, { "name": "now", "desc": "当前时间(毫秒)。", "type": "uint32_t", "annotation": { "private": true } }, { "name": "time_scale", "desc": "时间倍率。", "type": "float_t", "annotation": { "private": true } }, { "name": "start_time", "desc": "起始时间(毫秒)。", "type": "uint32_t", "annotation": { "private": true } }, { "name": "delay", "desc": "延迟执行时间(毫秒)。", "type": "uint32_t", "annotation": { "private": true } }, { "name": "duration", "desc": "单次动画执行时间(毫秒)。", "type": "uint32_t", "annotation": { "private": true } }, { "name": "state", "desc": "动画的状态。", "type": "animator_state_t", "annotation": { "private": true } }, { "name": "emitter", "desc": "emitter", "type": "uint32_t", "annotation": { "private": true } }, { "name": "destroy_when_done;", "desc": "播放完成时是否自动销毁(缺省销毁)。", "type": "bool_t", "annotation": { "private": true } }, { "name": "forever", "desc": "是否永远播放(yoyo_times/repeat_times为0时，自动设置此标志)。", "type": "bool_t", "annotation": { "private": true } }, { "name": "widget_destroy_id", "desc": "widget_destroy_id。", "type": "uint32_t", "annotation": { "private": true } }, { "name": "easing", "desc": "插值函数。", "type": "easing_func_t", "annotation": { "private": true } }, { "name": "update", "desc": "update函数，子类需要实现。", "type": "widget_animator_update_t", "annotation": { "private": true } }, { "name": "destroy", "desc": "destroy函数，子类需要实现。", "type": "widget_animator_destroy_t", "annotation": { "private": true } } ], "header": "base/widget_animator.h", "desc": "控件动画接口。", "name": "widget_animator_t", "level": 1 }, { "type": "enum", "desc": "控件的属性。", "consts": [ { "desc": "用于执行某些特殊的命令（比如控制动画的启停），主要是方便MVVM通过属性来控制动画。", "name": "WIDGET_PROP_EXEC" }, { "desc": "X坐标。", "name": "WIDGET_PROP_X" }, { "desc": "Y坐标。", "name": "WIDGET_PROP_Y" }, { "desc": "宽度。", "name": "WIDGET_PROP_W" }, { "desc": "高度。", "name": "WIDGET_PROP_H" }, { "desc": "inputing。", "name": "WIDGET_PROP_INPUTING" }, { "desc": "caret x。", "name": "WIDGET_PROP_CARET_X" }, { "desc": "caret y。", "name": "WIDGET_PROP_CARET_Y" }, { "desc": "脏矩形超出控件本身大小的最大范围。", "name": "WIDGET_PROP_DIRTY_RECT_TOLERANCE" }, { "desc": "bidi type(rtl,ltr,auto,wrtl,wltr,lro,rlo)。", "name": "WIDGET_PROP_BIDI" }, { "desc": "Canvas。", "name": "WIDGET_PROP_CANVAS" }, { "desc": "Canvas。", "name": "WIDGET_PROP_LOCALIZE_OPTIONS" }, { "desc": "Native Window。", "name": "WIDGET_PROP_NATIVE_WINDOW" }, { "desc": "dialog highlight。", "name": "WIDGET_PROP_HIGHLIGHT" }, { "desc": "slider中的bar的的宽度或高度。", "name": "WIDGET_PROP_BAR_SIZE" }, { "desc": "不透明度。", "name": "WIDGET_PROP_OPACITY" }, { "desc": "最小宽度。", "name": "WIDGET_PROP_MIN_W" }, { "desc": "最大宽度。", "name": "WIDGET_PROP_MAX_W" }, { "desc": "子控件布局参数。", "name": "WIDGET_PROP_CHILDREN_LAYOUT" }, { "desc": "子控件布局参数(过时)。", "name": "WIDGET_PROP_LAYOUT" }, { "desc": "控件布局参数。", "name": "WIDGET_PROP_SELF_LAYOUT" }, { "desc": "layout宽度。", "name": "WIDGET_PROP_LAYOUT_W" }, { "desc": "layout高度。", "name": "WIDGET_PROP_LAYOUT_H" }, { "desc": "虚拟宽度。", "name": "WIDGET_PROP_VIRTUAL_W" }, { "desc": "虚拟高度。", "name": "WIDGET_PROP_VIRTUAL_H" }, { "desc": "名称。", "name": "WIDGET_PROP_NAME" }, { "desc": "类型。", "name": "WIDGET_PROP_TYPE" }, { "desc": "是否可以关闭。", "name": "WIDGET_PROP_CLOSABLE" }, { "desc": "鼠标指针。", "name": "WIDGET_PROP_POINTER_CURSOR" }, { "desc": "值。", "name": "WIDGET_PROP_VALUE" }, { "desc": "长度。", "name": "WIDGET_PROP_LENGTH" }, { "desc": "文本。", "name": "WIDGET_PROP_TEXT" }, { "desc": "待翻译文本。", "name": "WIDGET_PROP_TR_TEXT" }, { "desc": "style。", "name": "WIDGET_PROP_STYLE" }, { "desc": "是否启用。", "name": "WIDGET_PROP_ENABLE" }, { "desc": "是否启用按键音等反馈。", "name": "WIDGET_PROP_FEEDBACK" }, { "desc": "是否启用floating布局。", "name": "WIDGET_PROP_FLOATING" }, { "desc": "边距。", "name": "WIDGET_PROP_MARGIN" }, { "desc": "间距。", "name": "WIDGET_PROP_SPACING" }, { "desc": "左边距。", "name": "WIDGET_PROP_LEFT_MARGIN" }, { "desc": "右边距。", "name": "WIDGET_PROP_RIGHT_MARGIN" }, { "desc": "顶边距。", "name": "WIDGET_PROP_TOP_MARGIN" }, { "desc": "底边距。", "name": "WIDGET_PROP_BOTTOM_MARGIN" }, { "desc": "步长。", "name": "WIDGET_PROP_STEP" }, { "desc": "是否可见。", "name": "WIDGET_PROP_VISIBLE" }, { "desc": "是否接受用户事件。", "name": "WIDGET_PROP_SENSITIVE" }, { "desc": "控件动画。", "name": "WIDGET_PROP_ANIMATION" }, { "desc": "窗口动画。", "name": "WIDGET_PROP_ANIM_HINT" }, { "desc": "窗口设置为全部大小。", "name": "WIDGET_PROP_FULLSCREEN" }, { "desc": "禁用窗口动画。", "name": "WIDGET_PROP_DISABLE_ANIM" }, { "desc": "打开窗口时的动画。", "name": "WIDGET_PROP_OPEN_ANIM_HINT" }, { "desc": "关闭窗口时的动画。", "name": "WIDGET_PROP_CLOSE_ANIM_HINT" }, { "desc": "最小值。", "name": "WIDGET_PROP_MIN" }, { "desc": "软键盘上action按钮的文本。", "name": "WIDGET_PROP_ACTION_TEXT" }, { "desc": "提示信息。", "name": "WIDGET_PROP_TIPS" }, { "desc": "需要翻译的提示信息。", "name": "WIDGET_PROP_TR_TIPS" }, { "desc": "输入类型。", "name": "WIDGET_PROP_INPUT_TYPE" }, { "desc": "自定义软键盘资源名称。", "name": "WIDGET_PROP_KEYBOARD" }, { "desc": "缺省获得焦点的子控件(可用控件名或类型)。", "name": "WIDGET_PROP_DEFAULT_FOCUSED_CHILD" }, { "desc": "只读模式。", "name": "WIDGET_PROP_READONLY" }, { "desc": "密码是否可见。", "name": "WIDGET_PROP_PASSWORD_VISIBLE" }, { "desc": "是否处于active状态。", "name": "WIDGET_PROP_ACTIVE" }, { "desc": "是否为垂直模式。", "name": "WIDGET_PROP_VERTICAL" }, { "desc": "是否显示文本。", "name": "WIDGET_PROP_SHOW_TEXT" }, { "desc": "X方向的偏移。", "name": "WIDGET_PROP_XOFFSET" }, { "desc": "Y方向的偏移。", "name": "WIDGET_PROP_YOFFSET" }, { "desc": "垂直对齐模式。", "name": "WIDGET_PROP_ALIGN_V" }, { "desc": "水平对齐模式。", "name": "WIDGET_PROP_ALIGN_H" }, { "desc": "是否自动播放或指定播放的时间。", "name": "WIDGET_PROP_AUTO_PLAY" }, { "desc": "是否循环播放或循环播放的次数。", "name": "WIDGET_PROP_LOOP" }, { "desc": "是否启用自动更正功能。", "name": "WIDGET_PROP_AUTO_FIX" }, { "desc": "编辑器在获得焦点时是否不选中文本。", "name": "WIDGET_PROP_SELECT_NONE_WHEN_FOCUSED" }, { "desc": "编辑器在获得焦点时是否打开输入法。", "name": "WIDGET_PROP_OPEN_IM_WHEN_FOCUSED" }, { "desc": "X最小值。", "name": "WIDGET_PROP_X_MIN" }, { "desc": "X最大值。", "name": "WIDGET_PROP_X_MAX" }, { "desc": "Y最小值。", "name": "WIDGET_PROP_Y_MIN" }, { "desc": "Y最大值。", "name": "WIDGET_PROP_Y_MAX" }, { "desc": "最大值。", "name": "WIDGET_PROP_MAX" }, { "desc": "让窗口管理器直接把按键发给自己。", "name": "WIDGET_PROP_GRAB_KEYS" }, { "desc": "行数或每行的高度。", "name": "WIDGET_PROP_ROW" }, { "desc": "控件状态。", "name": "WIDGET_PROP_STATE_FOR_STYLE" }, { "desc": "窗口主题名称。", "name": "WIDGET_PROP_THEME" }, { "desc": "window stage", "name": "WIDGET_PROP_STAGE" }, { "desc": "图片管理器。", "name": "WIDGET_PROP_IMAGE_MANAGER" }, { "desc": "资源管理器。", "name": "WIDGET_PROP_ASSETS_MANAGER" }, { "desc": "locale_info。", "name": "WIDGET_PROP_LOCALE_INFO" }, { "desc": "字体管理器。", "name": "WIDGET_PROP_FONT_MANAGER" }, { "desc": "窗口的主题对象。", "name": "WIDGET_PROP_THEME_OBJ" }, { "desc": "缺省的主题对象。", "name": "WIDGET_PROP_DEFAULT_THEME_OBJ" }, { "desc": "项的宽度。", "name": "WIDGET_PROP_ITEM_WIDTH" }, { "desc": "项的高度。", "name": "WIDGET_PROP_ITEM_HEIGHT" }, { "desc": "项的缺省高度。", "name": "WIDGET_PROP_DEFAULT_ITEM_HEIGHT" }, { "desc": "X方向是否可拖动。", "name": "WIDGET_PROP_XSLIDABLE" }, { "desc": "Y方向是否可拖动。", "name": "WIDGET_PROP_YSLIDABLE" }, { "desc": "重复次数。", "name": "WIDGET_PROP_REPEAT" }, { "desc": "是否启用长按。", "name": "WIDGET_PROP_ENABLE_LONG_PRESS" }, { "desc": "是否启用动画。", "name": "WIDGET_PROP_ANIMATABLE" }, { "desc": "是否自动隐藏滚动条。", "name": "WIDGET_PROP_AUTO_HIDE_SCROLL_BAR" }, { "desc": "图片名称。", "name": "WIDGET_PROP_IMAGE" }, { "desc": "显示格式。", "name": "WIDGET_PROP_FORMAT" }, { "desc": "图片绘制类型。", "name": "WIDGET_PROP_DRAW_TYPE" }, { "desc": "是否可选择。", "name": "WIDGET_PROP_SELECTABLE" }, { "desc": "是否可点击。", "name": "WIDGET_PROP_CLICKABLE" }, { "desc": "X方向缩放比例。", "name": "WIDGET_PROP_SCALE_X" }, { "desc": "Y方向缩放比例。", "name": "WIDGET_PROP_SCALE_Y" }, { "desc": "x锚点。", "name": "WIDGET_PROP_ANCHOR_X" }, { "desc": "y锚点。", "name": "WIDGET_PROP_ANCHOR_Y" }, { "desc": "选中角度(幅度)", "name": "WIDGET_PROP_ROTATION" }, { "desc": "紧凑模式。", "name": "WIDGET_PROP_COMPACT" }, { "desc": "是否支持滚动。", "name": "WIDGET_PROP_SCROLLABLE" }, { "desc": "图标名称。", "name": "WIDGET_PROP_ICON" }, { "desc": "选项集合。", "name": "WIDGET_PROP_OPTIONS" }, { "desc": "是否被选中。", "name": "WIDGET_PROP_SELECTED" }, { "desc": "是否被勾选。", "name": "WIDGET_PROP_CHECKED" }, { "desc": "active状态下的图标。", "name": "WIDGET_PROP_ACTIVE_ICON" }, { "desc": "动态加载UI名字。", "name": "WIDGET_PROP_LOAD_UI" }, { "desc": "要打开窗口的名称。", "name": "WIDGET_PROP_OPEN_WINDOW" }, { "desc": "被选中项的索引。", "name": "WIDGET_PROP_SELECTED_INDEX" }, { "desc": "点击窗口时关闭窗口。", "name": "WIDGET_PROP_CLOSE_WHEN_CLICK" }, { "desc": "点击窗口外部时关闭窗口。", "name": "WIDGET_PROP_CLOSE_WHEN_CLICK_OUTSIDE" }, { "desc": "行间距。", "name": "WIDGET_PROP_LINE_GAP" }, { "desc": "背景颜色(仅仅使用于color tile)。", "name": "WIDGET_PROP_BG_COLOR" }, { "desc": "边框颜色(仅仅使用于color tile)。", "name": "WIDGET_PROP_BORDER_COLOR" }, { "desc": "延迟时间(毫秒)", "name": "WIDGET_PROP_DELAY" }, { "desc": "是否为键盘。", "name": "WIDGET_PROP_IS_KEYBOARD" }, { "desc": "是否为焦点控件。", "name": "WIDGET_PROP_FOCUSED" }, { "desc": "(过时请用focused)。", "name": "WIDGET_PROP_FOCUS" }, { "desc": "是否支持焦点停留。", "name": "WIDGET_PROP_FOCUSABLE" }, { "desc": "是否支持焦点状态(如果希望style支持焦点状态，但有不希望焦点停留，可用本属性)。", "name": "WIDGET_PROP_WITH_FOCUS_STATE" }, { "desc": "将焦点移到前一个的键值。", "name": "WIDGET_PROP_MOVE_FOCUS_PREV_KEY" }, { "desc": "将焦点移到后一个的键值。", "name": "WIDGET_PROP_MOVE_FOCUS_NEXT_KEY" }, { "desc": "将焦点向上移动的键值。", "name": "WIDGET_PROP_MOVE_FOCUS_UP_KEY" }, { "desc": "将焦点向下移动的键值。", "name": "WIDGET_PROP_MOVE_FOCUS_DOWN_KEY" }, { "desc": "将焦点向左移动的键值。", "name": "WIDGET_PROP_MOVE_FOCUS_LEFT_KEY" }, { "desc": "将焦点向右移动的键值。", "name": "WIDGET_PROP_MOVE_FOCUS_RIGHT_KEY" } ], "header": "base/widget_consts.h", "name": "widget_prop_t", "prefix": "WIDGET_PROP_", "annotation": { "scriptable": true, "string": true }, "level": 1 }, { "type": "enum", "desc": "控件的类型。", "consts": [ { "desc": "无特殊类型。", "name": "WIDGET_TYPE_NONE" }, { "desc": "窗口管理器。", "name": "WIDGET_TYPE_WINDOW_MANAGER" }, { "desc": "普通窗口。", "name": "WIDGET_TYPE_NORMAL_WINDOW" }, { "desc": "overlay窗口。", "name": "WIDGET_TYPE_OVERLAY" }, { "desc": "工具条。", "name": "WIDGET_TYPE_TOOL_BAR" }, { "desc": "对话框。", "name": "WIDGET_TYPE_DIALOG" }, { "desc": "弹出窗口。", "name": "WIDGET_TYPE_POPUP" }, { "desc": "system bar window", "name": "WIDGET_TYPE_SYSTEM_BAR" }, { "desc": "system bar window ato bottom", "name": "WIDGET_TYPE_SYSTEM_BAR_BOTTOM" }, { "desc": "精灵窗口。", "name": "WIDGET_TYPE_SPRITE" }, { "desc": "键盘窗口。", "name": "WIDGET_TYPE_KEYBOARD" }, { "desc": "拖放状态窗口。", "name": "WIDGET_TYPE_DND" }, { "desc": "文本控件。", "name": "WIDGET_TYPE_LABEL" }, { "desc": "按钮控件。", "name": "WIDGET_TYPE_BUTTON" }, { "desc": "图片控件。", "name": "WIDGET_TYPE_IMAGE" }, { "desc": "文本编辑控件。", "name": "WIDGET_TYPE_EDIT" }, { "desc": "进度条控件。", "name": "WIDGET_TYPE_PROGRESS_BAR" }, { "desc": "分组控件。", "name": "WIDGET_TYPE_GROUP_BOX" }, { "desc": "多选按钮控件。", "name": "WIDGET_TYPE_CHECK_BUTTON" }, { "desc": "单选按钮控件。", "name": "WIDGET_TYPE_RADIO_BUTTON" }, { "desc": "对话框标题。", "name": "WIDGET_TYPE_DIALOG_TITLE" }, { "desc": "对话框客户区域。", "name": "WIDGET_TYPE_DIALOG_CLIENT" }, { "desc": "滑块控件。", "name": "WIDGET_TYPE_SLIDER" }, { "desc": "视图控件。", "name": "WIDGET_TYPE_VIEW" }, { "desc": "下拉选择框控件。", "name": "WIDGET_TYPE_COMBO_BOX" }, { "desc": "下拉选择框的列表项控件。", "name": "WIDGET_TYPE_COMBO_BOX_ITEM" }, { "desc": "滑动视图控件。", "name": "WIDGET_TYPE_SLIDE_VIEW" }, { "desc": "滑动视图的指示器控件。", "name": "WIDGET_TYPE_SLIDE_INDICATOR" }, { "desc": "滑动视图的指示器控件（圆弧显示）。", "name": "WIDGET_TYPE_SLIDE_INDICATOR_ARC" }, { "desc": "多页控件。", "name": "WIDGET_TYPE_PAGES" }, { "desc": "标签按钮控件。", "name": "WIDGET_TYPE_TAB_BUTTON" }, { "desc": "标签控件。", "name": "WIDGET_TYPE_TAB_CONTROL" }, { "desc": "标签按钮分组控件。", "name": "WIDGET_TYPE_TAB_BUTTON_GROUP" }, { "desc": "按钮分组控件。", "name": "WIDGET_TYPE_BUTTON_GROUP" }, { "desc": "候选字控件。", "name": "WIDGET_TYPE_CANDIDATES" }, { "desc": "数值编辑控件。", "name": "WIDGET_TYPE_SPIN_BOX" }, { "desc": "拖动块控件。", "name": "WIDGET_TYPE_DRAGGER" }, { "desc": "滚动条控件。", "name": "WIDGET_TYPE_SCROLL_BAR" }, { "desc": "桌面版滚动条控件。", "name": "WIDGET_TYPE_SCROLL_BAR_DESKTOP" }, { "desc": "移动版滚动条控件。", "name": "WIDGET_TYPE_SCROLL_BAR_MOBILE" }, { "desc": "滚动视图控件。", "name": "WIDGET_TYPE_SCROLL_VIEW" }, { "desc": "列表视图控件。", "name": "WIDGET_TYPE_LIST_VIEW" }, { "desc": "水平列表视图控件。", "name": "WIDGET_TYPE_LIST_VIEW_H" }, { "desc": "列表项控件。", "name": "WIDGET_TYPE_LIST_ITEM" }, { "desc": "颜色选择器控件。", "name": "WIDGET_TYPE_COLOR_PICKER" }, { "desc": "颜色选择器组件控件。", "name": "WIDGET_TYPE_COLOR_COMPONENT" }, { "desc": "颜色块控件。", "name": "WIDGET_TYPE_COLOR_TILE" }, { "desc": "裁剪控件。", "name": "WIDGET_TYPE_CLIP_VIEW" }, { "desc": "富文本控件。", "name": "WIDGET_TYPE_RICH_TEXT" }, { "desc": "AppBar控件。", "name": "WIDGET_TYPE_APP_BAR" }, { "desc": "网格控件。", "name": "WIDGET_TYPE_GRID" }, { "desc": "网格项目控件。", "name": "WIDGET_TYPE_GRID_ITEM" }, { "desc": "行控件。", "name": "WIDGET_TYPE_ROW" }, { "desc": "列控件。", "name": "WIDGET_TYPE_COLUMN" }, { "desc": "电阻屏校准窗口。", "name": "WIDGET_TYPE_CALIBRATION_WIN" } ], "header": "base/widget_consts.h", "name": "widget_type_t", "prefix": "WIDGET_TYPE_", "annotation": { "scriptable": true, "string": true }, "level": 1 }, { "type": "enum", "desc": "窗口的生命周期常量定义。", "consts": [ { "desc": "初始状态。", "name": "WINDOW_STAGE_NONE" }, { "desc": "创建完成。", "name": "WINDOW_STAGE_CREATED" }, { "desc": "窗口已经打开(窗口打开动画完成后)", "name": "WINDOW_STAGE_OPENED" }, { "desc": "窗口已关闭。", "name": "WINDOW_STAGE_CLOSED" }, { "desc": "窗口挂起状态。", "name": "WINDOW_STAGE_SUSPEND" } ], "header": "base/widget_consts.h", "name": "window_stage_t", "prefix": "WINDOW_STAGE_", "annotation": { "scriptable": true }, "level": 1 }, { "type": "enum", "desc": "窗口的closable常量定义。", "consts": [ { "desc": "窗口可关闭。", "name": "WINDOW_CLOSABLE_YES" }, { "desc": "窗口不可关闭。", "name": "WINDOW_CLOSABLE_NO" }, { "desc": "窗口需要确认后才能关闭。", "name": "WINDOW_CLOSABLE_CONFIRM" } ], "header": "base/widget_consts.h", "name": "window_closable_t", "prefix": "WINDOW_CLOSABLE_", "annotation": { "scriptable": true }, "level": 1 }, { "type": "enum", "desc": "控件状态常量定义。\n\n这里指定常用的状态值，扩展控件可以在自己的头文件中定义私有的状态。", "consts": [ { "desc": "无效状态。", "name": "WIDGET_STATE_NONE" }, { "desc": "正常状态。", "name": "WIDGET_STATE_NORMAL" }, { "desc": "指针按下状态。", "name": "WIDGET_STATE_PRESSED" }, { "desc": "指针悬浮状态。", "name": "WIDGET_STATE_OVER" }, { "desc": "禁用状态。", "name": "WIDGET_STATE_DISABLE" }, { "desc": "聚焦状态。", "name": "WIDGET_STATE_FOCUSED" }, { "desc": "勾选状态。", "name": "WIDGET_STATE_CHECKED" }, { "desc": "没勾选状态。", "name": "WIDGET_STATE_UNCHECKED" }, { "desc": "编辑器无内容状态。", "name": "WIDGET_STATE_EMPTY" }, { "desc": "编辑器无内容同时聚焦的状态。", "name": "WIDGET_STATE_EMPTY_FOCUS" }, { "desc": "输入错误状态。", "name": "WIDGET_STATE_ERROR" }, { "desc": "选中状态。", "name": "WIDGET_STATE_SELECTED" }, { "desc": "正常状态(选中项)。", "name": "WIDGET_STATE_NORMAL_OF_CHECKED" }, { "desc": "指针按下状态(选中项)。", "name": "WIDGET_STATE_PRESSED_OF_CHECKED" }, { "desc": "指针悬浮状态(选中项)。", "name": "WIDGET_STATE_OVER_OF_CHECKED" }, { "desc": "禁用状态(选中项)。", "name": "WIDGET_STATE_DISABLE_OF_CHECKED" }, { "desc": "焦点状态(选中项)。", "name": "WIDGET_STATE_FOCUSED_OF_CHECKED" }, { "desc": "正常状态(当前项)。", "name": "WIDGET_STATE_NORMAL_OF_ACTIVE" }, { "desc": "指针按下状态(当前项)。", "name": "WIDGET_STATE_PRESSED_OF_ACTIVE" }, { "desc": "指针悬浮状态(当前项)。", "name": "WIDGET_STATE_OVER_OF_ACTIVE" }, { "desc": "禁用状态(当前项)。", "name": "WIDGET_STATE_DISABLE_OF_ACTIVE" }, { "desc": "焦点状态(当前项)。", "name": "WIDGET_STATE_FOCUSED_OF_ACTIVE" } ], "header": "base/widget_consts.h", "name": "widget_state_t", "prefix": "WIDGET_", "annotation": { "scriptable": true, "string": true }, "level": 1 }, { "type": "enum", "desc": "控件鼠标光标常量定义。", "consts": [ { "desc": "默认光标。", "name": "WIDGET_CURSOR_DEFAULT" }, { "desc": "文本选择光标。", "name": "WIDGET_CURSOR_EDIT" }, { "desc": "手指光标。", "name": "WIDGET_CURSOR_HAND" }, { "desc": "等待光标。", "name": "WIDGET_CURSOR_WAIT" }, { "desc": "叉光标。", "name": "WIDGET_CURSOR_CROSS" }, { "desc": "Slashed circle or crossbones。", "name": "WIDGET_CURSOR_NO" }, { "desc": "Double arrow pointing northwest and southeast。", "name": "WIDGET_CURSOR_SIZENWSE" }, { "desc": "Double arrow pointing northeast and southwest。", "name": "WIDGET_CURSOR_SIZENESW" }, { "desc": "Double arrow pointing west and east。", "name": "WIDGET_CURSOR_SIZEWE" }, { "desc": "Double arrow pointing north and south。", "name": "WIDGET_CURSOR_SIZENS" }, { "desc": "Four pointed arrow pointing north, south, east, and west。", "name": "WIDGET_CURSOR_SIZEALL" } ], "header": "base/widget_consts.h", "name": "widget_cursor_t", "prefix": "WIDGET_", "annotation": { "scriptable": true, "string": true }, "level": 1 }, { "type": "enum", "desc": "类型常量定义。", "consts": [ { "desc": "无效类型。", "name": "VALUE_TYPE_INVALID" }, { "desc": "BOOL类型。", "name": "VALUE_TYPE_BOOL" }, { "desc": "int8_t类型。", "name": "VALUE_TYPE_INT8" }, { "desc": "uint8_t类型。", "name": "VALUE_TYPE_UINT8" }, { "desc": "int16_t类型。", "name": "VALUE_TYPE_INT16" }, { "desc": "uint16_t类型。", "name": "VALUE_TYPE_UINT16" }, { "desc": "int32_t类型。", "name": "VALUE_TYPE_INT32" }, { "desc": "uint32_t类型。", "name": "VALUE_TYPE_UINT32" }, { "desc": "int64_t类型。", "name": "VALUE_TYPE_INT64" }, { "desc": "uint64_t类型。", "name": "VALUE_TYPE_UINT64" }, { "desc": "void*类型。", "name": "VALUE_TYPE_POINTER" }, { "desc": "float_t类型。", "name": "VALUE_TYPE_FLOAT" }, { "desc": "float类型。", "name": "VALUE_TYPE_FLOAT32" }, { "desc": "double类型。", "name": "VALUE_TYPE_DOUBLE" }, { "desc": "char*类型。", "name": "VALUE_TYPE_STRING" }, { "desc": "wchar_t*类型。", "name": "VALUE_TYPE_WSTRING" }, { "desc": "object_t*类型。", "name": "VALUE_TYPE_OBJECT" }, { "desc": "带长度的字符串。", "name": "VALUE_TYPE_SIZED_STRING" }, { "desc": "二进制数据。", "name": "VALUE_TYPE_BINARY" }, { "desc": "二进制数据(UBJSON)。", "name": "VALUE_TYPE_UBJSON" }, { "desc": "特殊用途。", "name": "VALUE_TYPE_TOKEN" } ], "header": "tkc/value.h", "name": "value_type_t", "prefix": "VALUE_TYPE_", "annotation": { "scriptable": true }, "level": 1 }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件。" }, { "type": "rect_t*", "name": "r", "desc": "无效化区域。" } ], "annotation": { "global": true }, "desc": "awtk默认的invalidate接口。", "name": "widget_invalidate_default", "return": { "type": "ret_t", "desc": "返回。" }, "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_on_event_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_on_paint_self_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_on_paint_children_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_on_keydown_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_on_keyup_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_on_pointer_down_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_on_pointer_move_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_on_pointer_up_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_on_copy_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_get_prop_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_set_prop_default", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件。" }, { "type": "xy_t", "name": "x", "desc": "坐标。" }, { "type": "xy_t", "name": "y", "desc": "坐标。" } ], "annotation": { "global": true }, "desc": "awtk默认的find_target接口。", "name": "widget_find_target_default", "return": { "type": "widget_t*", "desc": "返回响应的控件。" }, "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "params": [], "annotation": { "global": true }, "desc": "", "name": "widget_on_paint_null", "type": "method", "header": "base/widget_vtable.h", "level": 1 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "获取子控件的个数。", "name": "widget_count_children", "return": { "type": "int32_t", "desc": "子控件的个数。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "int32_t", "name": "index", "desc": "索引。" } ], "annotation": { "scriptable": true }, "desc": "获取指定索引的子控件。", "name": "widget_get_child", "return": { "type": "widget_t*", "desc": "子控件。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "获取原生窗口对象。", "name": "widget_get_native_window", "return": { "type": "native_window_t*", "desc": "原生窗口对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "获取控件在父控件中的索引编号。", "name": "widget_index_of", "return": { "type": "int32_t", "desc": "在父控件中的索引编号。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "deconstructor": true, "scriptable": true }, "desc": "关闭控件所在的窗口。", "name": "widget_close_window", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" } ], "annotation": { "scriptable": true }, "desc": "移动控件。", "name": "widget_move", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": { "scriptable": true }, "desc": "调整控件的大小。", "name": "widget_resize", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": { "scriptable": true }, "desc": "移动控件并调整控件的大小。", "name": "widget_move_resize", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "int32_t", "name": "value", "desc": "值。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的值。\n只是对widget\\_set\\_prop的包装，值的意义由子类控件决定。", "name": "widget_set_value", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "int32_t", "name": "value", "desc": "值。" }, { "type": "uint32_t", "name": "duration", "desc": "动画持续时间(毫秒)。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的值(以动画形式变化到指定的值)。\n只是对widget\\_set\\_prop的包装，值的意义由子类控件决定。", "name": "widget_animate_value_to", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "int32_t", "name": "delta", "desc": "增量。" } ], "annotation": { "scriptable": true }, "desc": "增加控件的值。\n只是对widget\\_set\\_prop的包装，值的意义由子类控件决定。", "name": "widget_add_value", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const wchar_t*", "name": "text", "desc": "文本。" } ], "annotation": {}, "desc": "设置控件的文本。\n只是对widget\\_set\\_prop的包装，文本的意义由子类控件决定。", "name": "widget_set_text", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "style", "desc": "style的名称。" } ], "annotation": { "scriptable": true }, "desc": "启用指定的主题。", "name": "widget_use_style", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "text", "desc": "文本。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的文本。\n只是对widget\\_set\\_prop的包装，文本的意义由子类控件决定。", "name": "widget_set_text_utf8", "alias": "set_text", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "子控件的名称。" }, { "type": "const char*", "name": "text", "desc": "文本。" } ], "annotation": { "scriptable": true }, "desc": "设置子控件的文本。\n只是对widget\\_set\\_prop的包装，文本的意义由子类控件决定。", "name": "widget_set_child_text_utf8", "alias": "set_child_text", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "子控件的名称。" }, { "type": "const char*", "name": "format", "desc": "格式字符串(如：\"%2.2lf\")。" }, { "type": "double", "name": "value", "desc": "浮点数值。" } ], "annotation": { "scriptable": true }, "desc": "用一个浮点数去设置子控件的文本。\n只是对widget\\_set\\_prop的包装，文本的意义由子类控件决定。", "name": "widget_set_child_text_with_double", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "text", "desc": "文本。" } ], "annotation": { "scriptable": true }, "desc": "获取翻译之后的文本，然后调用widget_set_text。", "name": "widget_set_tr_text", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "获取控件的值。只是对widget\\_get\\_prop的包装，值的意义由子类控件决定。", "name": "widget_get_value", "return": { "type": "int32_t", "desc": "返回值。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "获取控件的文本。\n只是对widget\\_get\\_prop的包装，文本的意义由子类控件决定。\n\n如果希望获取UTF8格式的文本，可以参考下面的代码：\n\n```c\nstr_t str;\nstr_init(&str, 0);\nstr_from_wstr(&str, widget_get_text(target));\nlog_debug(\"%s: %s\\n\", target->name, str.str);\nstr_reset(&str);\n```", "name": "widget_get_text", "return": { "type": "const wchar_t*", "desc": "返回文本。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "point_t*", "name": "p", "desc": "坐标点。" } ], "annotation": {}, "desc": "将屏幕坐标转换成控件内的本地坐标，即相对于控件左上角的坐标。", "name": "widget_to_local", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "point_t*", "name": "p", "desc": "坐标点。" } ], "annotation": {}, "desc": "将控件内的本地坐标转换成全局坐标。", "name": "widget_to_global", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "point_t*", "name": "p", "desc": "坐标点。" } ], "annotation": {}, "desc": "将控件内的本地坐标转换成屏幕上的坐标。", "name": "widget_to_screen", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "名称。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的名称。", "name": "widget_set_name", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "主题的名称。" } ], "annotation": { "scriptable": true }, "desc": "设置theme的名称，用于动态切换主题。名称与当前主题名称相同，则重新加载全部资源。\n\n> 目前只支持带有文件系统的平台。", "name": "widget_set_theme", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "cursor", "desc": "图片名称(无扩展名)。" } ], "annotation": { "scriptable": true }, "desc": "设置鼠标指针的图片名。", "name": "widget_set_pointer_cursor", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "animation", "desc": "动画参数。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的动画参数(仅用于在UI文件使用)。\n请参考[控件动画](https://github.com/zlgopen/awtk/blob/master/docs/widget_animator.md)", "name": "widget_set_animation", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "animation", "desc": "动画参数。" } ], "annotation": { "scriptable": true }, "desc": "创建动画。\n请参考[控件动画](https://github.com/zlgopen/awtk/blob/master/docs/widget_animator.md)\n\n* 除非指定auto_start=false，动画创建后自动启动。\n* 除非指定auto_destroy=false，动画播放完成后自动销毁。", "name": "widget_create_animator", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" } ], "annotation": { "scriptable": true }, "desc": "播放动画。\n请参考[控件动画](https://github.com/zlgopen/awtk/blob/master/docs/widget_animator.md)\n\n* 1.widget为NULL时，播放所有名称为name的动画。\n* 2.name为NULL时，播放所有widget相关的动画。\n* 3.widget和name均为NULL，播放所有动画。", "name": "widget_start_animator", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" }, { "type": "float_t", "name": "time_scale", "desc": "时间倍率。" } ], "annotation": { "scriptable": true }, "desc": "设置动画的时间倍率，<0: 时间倒退，<1: 时间变慢，>1 时间变快。\n请参考[控件动画](https://github.com/zlgopen/awtk/blob/master/docs/widget_animator.md)\n\n* 1.widget为NULL时，设置所有名称为name的动画的时间倍率。\n* 2.name为NULL时，设置所有widget相关的动画的时间倍率。\n* 3.widget和name均为NULL，设置所有动画的时间倍率。", "name": "widget_set_animator_time_scale", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" } ], "annotation": { "scriptable": true }, "desc": "暂停动画。\n请参考[控件动画](https://github.com/zlgopen/awtk/blob/master/docs/widget_animator.md)\n\n* 1.widget为NULL时，暂停所有名称为name的动画。\n* 2.name为NULL时，暂停所有widget相关的动画。\n* 3.widget和name均为NULL，暂停所有动画。", "name": "widget_pause_animator", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" } ], "annotation": {}, "desc": "查找指定名称的动画。", "name": "widget_find_animator", "return": { "type": "widget_animator_t*", "desc": "成功返回动画对象，失败返回NULL。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" } ], "annotation": { "scriptable": true }, "desc": "停止动画(控件的相应属性回归原位)。\n请参考[控件动画](https://github.com/zlgopen/awtk/blob/master/docs/widget_animator.md)\n\n* 1.widget为NULL时，停止所有名称为name的动画。\n* 2.name为NULL时，停止所有widget相关的动画。\n* 3.widget和name均为NULL，停止所有动画。", "name": "widget_stop_animator", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "动画名称。" } ], "annotation": { "scriptable": true }, "desc": "销毁动画。\n请参考[控件动画](https://github.com/zlgopen/awtk/blob/master/docs/widget_animator.md)\n\n* 1.widget为NULL时，销毁所有名称为name的动画。\n* 2.name为NULL时，销毁所有widget相关的动画。\n* 3.widget和name均为NULL，销毁所有动画。", "name": "widget_destroy_animator", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "enable", "desc": "是否可用性。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的可用性。", "name": "widget_set_enable", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "feedback", "desc": "是否启用反馈。" } ], "annotation": { "scriptable": true }, "desc": "设置控件是否启用反馈。", "name": "widget_set_feedback", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "floating", "desc": "是否启用floating布局。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的floating标志。\n> floating的控件不受父控件的子控件布局参数的影响。", "name": "widget_set_floating", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "focused", "desc": "是否获得焦点。" } ], "annotation": { "scriptable": true }, "desc": "设置控件是否获得焦点。", "name": "widget_set_focused", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "focusable", "desc": "是否可获得焦点。" } ], "annotation": { "scriptable": true }, "desc": "设置控件是否可获得焦点。", "name": "widget_set_focusable", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "state", "desc": "状态(必须为真正的常量字符串，在widget的整个生命周期有效)。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的状态。", "name": "widget_set_state", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint8_t", "name": "opacity", "desc": "不透明度(取值0-255，0表示完全透明，255表示完全不透明)。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的不透明度。\n\n>在嵌入式平台，半透明效果会使性能大幅下降，请谨慎使用。", "name": "widget_set_opacity", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint16_t", "name": "dirty_rect_tolerance", "desc": "控件脏脏矩形超出控件本身大小的最大范。" } ], "annotation": { "scriptable": true }, "desc": "设置控件脏矩形超出控件本身大小的最大范围(一般不用指定)。", "name": "widget_set_dirty_rect_tolerance", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "销毁全部子控件。", "name": "widget_destroy_children", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "widget_t*", "name": "child", "desc": "子控件对象。" } ], "annotation": { "scriptable": true }, "desc": "加入一个子控件。", "name": "widget_add_child", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "widget_t*", "name": "child", "desc": "子控件对象。" } ], "annotation": { "scriptable": true }, "desc": "移出指定的子控件(并不销毁)。", "name": "widget_remove_child", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint32_t", "name": "index", "desc": "位置序数(大于等于总个数，则放到最后)。" }, { "type": "widget_t*", "name": "child", "desc": "子控件对象。" } ], "annotation": { "scriptable": true }, "desc": "插入子控件到指定的位置。", "name": "widget_insert_child", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint32_t", "name": "index", "desc": "位置序数(大于等于总个数，则放到最后)。" } ], "annotation": { "scriptable": true }, "desc": "调整控件在父控件中的位置序数。", "name": "widget_restack", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "子控件的名称。" } ], "annotation": { "scriptable": true }, "desc": "查找指定名称的子控件(同widget_lookup(widget, name, FALSE))。", "name": "widget_child", "return": { "type": "widget_t*", "desc": "子控件或NULL。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "子控件的名称。" }, { "type": "bool_t", "name": "recursive", "desc": "是否递归查找全部子控件。" } ], "annotation": { "scriptable": true }, "desc": "查找指定名称的子控件(返回第一个)。", "name": "widget_lookup", "return": { "type": "widget_t*", "desc": "子控件或NULL。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "type", "desc": "子控件的名称。" }, { "type": "bool_t", "name": "recursive", "desc": "是否递归查找全部子控件。" } ], "annotation": { "scriptable": true }, "desc": "查找指定类型的子控件(返回第一个)。", "name": "widget_lookup_by_type", "return": { "type": "widget_t*", "desc": "子控件或NULL。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "visible", "desc": "是否可见。" }, { "type": "bool_t", "name": "recursive", "desc": "是否递归设置全部子控件。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的可见性。", "name": "widget_set_visible", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "visible", "desc": "是否可见。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的可见性(不触发repaint和relayout)。", "name": "widget_set_visible_only", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "sensitive", "desc": "是否接受用户事件。" } ], "annotation": { "scriptable": true }, "desc": "设置控件是否接受用户事件。", "name": "widget_set_sensitive", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型。" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": { "scriptable": "custom" }, "desc": "注册指定事件的处理函数。\n使用示例：\n\n```c\nwidget_t* ok = button_create(win, 10, 10, 80, 30);\nwidget_on(ok, EVT_CLICK, on_click, NULL);\n\n```", "name": "widget_on", "return": { "type": "uint32_t", "desc": "返回id，用于widget_off。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型。" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" }, { "type": "uint32_t", "name": "tag", "desc": "tag。" } ], "annotation": {}, "desc": "注册指定tag的事件处理函数。\n\n> 注册时指定一个tag，可用widget\\_off\\_by\\_tag注销相同tag的事件处理函数。", "name": "widget_on_with_tag", "return": { "type": "uint32_t", "desc": "返回id，用于widget_off。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint32_t", "name": "id", "desc": "widget_on返回的ID。" } ], "annotation": { "scriptable": true }, "desc": "注销指定事件的处理函数。", "name": "widget_off", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "子控件的名称。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型。" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": {}, "desc": "为指定名称的子控件注册指定事件的处理函数。\n递归查找指定名称的子控件，然后为其注册指定事件的处理函数。", "name": "widget_child_on", "return": { "type": "uint32_t", "desc": "返回id，用于widget_off。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "event_type_t", "name": "type", "desc": "事件类型。" }, { "type": "event_func_t", "name": "on_event", "desc": "事件处理函数。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": {}, "desc": "注销指定函数的事件处理函数。", "name": "widget_off_by_func", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "void*", "name": "ctx", "desc": "事件处理函数上下文。" } ], "annotation": {}, "desc": "注销指定ctx的事件处理函数。", "name": "widget_off_by_ctx", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint32_t", "name": "tag", "desc": "tag。" } ], "annotation": {}, "desc": "注销指定tag的事件处理函数。", "name": "widget_off_by_tag", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "rect_t*", "name": "r", "desc": "矩形对象(widget本地坐标)。" } ], "annotation": {}, "desc": "请求重绘指定的区域，如果widget->dirty已经为TRUE，直接返回。", "name": "widget_invalidate", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "rect_t*", "name": "r", "desc": "矩形对象(widget本地坐标)。" } ], "annotation": { "scriptable": true }, "desc": "请求强制重绘控件。", "name": "widget_invalidate_force", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "画布对象。" } ], "annotation": {}, "desc": "绘制控件到一个canvas上。", "name": "widget_paint", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "画布对象。" }, { "type": "const wchar_t*", "name": "str", "desc": "文本。" }, { "type": "uint32_t", "name": "size", "desc": "文本长度。" }, { "type": "rect_t*", "name": "r", "desc": "矩形区域。" }, { "type": "bool_t", "name": "ellipses", "desc": "宽度不够时是否显示省略号。" } ], "annotation": {}, "desc": "在canvas绘制一行文本。", "name": "widget_draw_text_in_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "event_t*", "name": "e", "desc": "事件。" } ], "annotation": {}, "desc": "分发一个事件。", "name": "widget_dispatch", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint32_t", "name": "type", "desc": "事件类型。" } ], "annotation": {}, "desc": "分发一个简单事件。", "name": "widget_dispatch_simple_event", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "event_t*", "name": "e", "desc": "事件。" } ], "annotation": {}, "desc": "分发一个事件控件本身及所有子控件。", "name": "widget_dispatch_recursive", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "value_t*", "name": "v", "desc": "返回属性的值。" } ], "annotation": {}, "desc": "获取控件指定属性的值。", "name": "widget_get_prop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "value_t*", "name": "v", "desc": "返回属性的缺省值。" } ], "annotation": {}, "desc": "获取控件指定属性的缺省值(在持久化控件时，无需保存缺省值)。", "name": "widget_get_prop_default_value", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "value_t*", "name": "v", "desc": "属性的值。" } ], "annotation": {}, "desc": "设置控件指定属性的值。", "name": "widget_set_prop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "const char*", "name": "v", "desc": "属性的值。" } ], "annotation": { "scriptable": true }, "desc": "设置字符串格式的属性。", "name": "widget_set_prop_str", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "const char*", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取字符串格式的属性。", "name": "widget_get_prop_str", "return": { "type": "const char*", "desc": "返回属性的值。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "void**", "name": "v", "desc": "属性的值。" } ], "annotation": {}, "desc": "设置指针格式的属性。", "name": "widget_set_prop_pointer", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" } ], "annotation": {}, "desc": "获取指针格式的属性。", "name": "widget_get_prop_pointer", "return": { "type": "void*", "desc": "返回属性的值。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "int32_t", "name": "v", "desc": "属性的值。" } ], "annotation": { "scriptable": true }, "desc": "设置整数格式的属性。", "name": "widget_set_prop_int", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "int32_t", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取整数格式的属性。", "name": "widget_get_prop_int", "return": { "type": "int32_t", "desc": "返回属性的值。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "bool_t", "name": "v", "desc": "属性的值。" } ], "annotation": { "scriptable": true }, "desc": "设置布尔格式的属性。", "name": "widget_set_prop_bool", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "属性的名称。" }, { "type": "bool_t", "name": "defval", "desc": "缺省值。" } ], "annotation": { "scriptable": true }, "desc": "获取布尔格式的属性。", "name": "widget_get_prop_bool", "return": { "type": "bool_t", "desc": "返回属性的值。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "判断当前控件所在的窗口是否已经打开。", "name": "widget_is_window_opened", "return": { "type": "bool_t", "desc": "返回当前控件所在的窗口是否已经打开。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "widget_t*", "name": "child", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "判断当前控件是否是指定控件的父控件(包括非直系)。", "name": "widget_is_parent_of", "return": { "type": "bool_t", "desc": "返回TRUE表示是，否则表示不是。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "widget_t*", "name": "child", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "判断当前控件是否是指定控件的直系父控件。", "name": "widget_is_direct_parent_of", "return": { "type": "bool_t", "desc": "返回TRUE表示是，否则表示不是。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "判断当前控件是否是窗口。", "name": "widget_is_window", "return": { "type": "bool_t", "desc": "返回当前控件是否是窗口。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "判断当前控件是否是设计窗口。", "name": "widget_is_designing_window", "return": { "type": "bool_t", "desc": "返回当前控件是否是设计窗口。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "判断当前控件是否是窗口管理器。", "name": "widget_is_window_manager", "return": { "type": "bool_t", "desc": "返回当前控件是否是窗口管理器。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "widget_t*", "name": "child", "desc": "子控件对象。" } ], "annotation": {}, "desc": "让指定子控件抓住事件。\n控件抓住之后，事件直接分发给该控件。", "name": "widget_grab", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "widget_t*", "name": "child", "desc": "子控件对象。" } ], "annotation": {}, "desc": "让指定子控件放弃抓住事件。", "name": "widget_ungrab", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "tk_visit_t", "name": "visit", "desc": "遍历的回调函数。" }, { "type": "void*", "name": "ctx", "desc": "回调函数的上下文。" } ], "annotation": { "scriptable": "custom" }, "desc": "遍历当前控件及子控件。", "name": "widget_foreach", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "获取当前控件所在的窗口。", "name": "widget_get_window", "return": { "type": "widget_t*", "desc": "窗口对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "获取当前的窗口管理器。", "name": "widget_get_window_manager", "return": { "type": "widget_t*", "desc": "窗口管理器对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "获取当前控件的类型名称。", "name": "widget_get_type", "return": { "type": "const char*", "desc": "返回类型名。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "widget_t*", "name": "parent", "desc": "clone新控件的parent对象。" } ], "annotation": { "scriptable": true }, "desc": "clone。", "name": "widget_clone", "return": { "type": "widget_t*", "desc": "返回clone的对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "widget_t*", "name": "other", "desc": "要比较的控件对象。" } ], "annotation": { "scriptable": true }, "desc": "判断两个widget是否相同。", "name": "widget_equal", "return": { "type": "bool_t", "desc": "返回TRUE表示相同，否则表示不同。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "timer_func_t", "name": "on_timer", "desc": "timer回调函数。" }, { "type": "uint32_t", "name": "duration_ms", "desc": "时间。" } ], "annotation": {}, "desc": "创建定时器。\n该定时器在控件销毁时自动销毁，**timer\\_info\\_t**的ctx为widget。\n如果定时器的生命周期与控件无关，请直接调用**timer_add**，以避免不必要的内存开销。\n\n使用示例：\n\n```c\nstatic ret_t digit_clock_on_timer(const timer_info_t* info) {\nwidget_t* widget = WIDGET(info->ctx);\n\nreturn RET_REPEAT;\n}\n...\nwidget_add_timer(widget, digit_clock_on_timer, 1000);\n\n```", "name": "widget_add_timer", "return": { "type": "uint32_t", "desc": "返回timer的ID，TK_INVALID_ID表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "uint32_t", "name": "timer_id", "desc": "timerID。" } ], "annotation": {}, "desc": "删除指定的timer。", "name": "widget_remove_timer", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "idle_func_t", "name": "on_idle", "desc": "idle回调函数。" } ], "annotation": {}, "desc": "创建idle。\n该idle在控件销毁时自动销毁，**idle\\_info\\_t**的ctx为widget。\n如果idle的生命周期与控件无关，请直接调用**idle_add**，以避免不必要的内存开销。", "name": "widget_add_idle", "return": { "type": "uint32_t", "desc": "返回idle的ID，TK_INVALID_ID表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "name", "desc": "图片名(不带扩展名)。" }, { "type": "bitmap_t*", "name": "bitmap", "desc": "返回图片对象。" } ], "annotation": {}, "desc": "加载图片。\n返回的bitmap对象只在当前调用有效，请不保存对bitmap对象的引用。\n\n\n使用示例：\n\n```c\nbitmap_t bitmap;\nwidget_load_image(widget, \"myimage\", &bitmap);\n\n```", "name": "widget_load_image", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bitmap_t*", "name": "bitmap", "desc": "图片对象。" } ], "annotation": {}, "desc": "卸载图片。\n\n> 一般不需要调用，只有确认在图片不再需要时才调用本函数卸载。", "name": "widget_unload_image", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "asset_type_t", "name": "type", "desc": "资源类型。" }, { "type": "const char*", "name": "name", "desc": "资源名。" } ], "annotation": {}, "desc": "加载资源。\n\n使用示例：\n\n```c\nconst asset_info_t* asset = widget_load_asset(widget, ASSET_TYPE_IMAGE, \"mysvg\");\n...\nwidget_unload_asset(widget, asset);\n```", "name": "widget_load_asset", "return": { "type": "const asset_info_t*", "desc": "返回资源句柄。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const asset_info_t*", "name": "asset", "desc": "资源句柄。" } ], "annotation": {}, "desc": "卸载资源。\n\n使用示例：\n\n```c\nconst asset_info_t* asset = widget_load_asset(widget, ASSET_TYPE_IMAGE, \"mysvg\");\n...\nwidget_unload_asset(widget, asset);\n```", "name": "widget_unload_asset", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为widget对象(供脚本语言使用)。", "name": "widget_cast", "return": { "type": "widget_t*", "desc": "widget对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "从父控件中移除控件，并调用unref函数销毁控件。\n\n> 一般无需直接调用，关闭窗口时，自动销毁相关控件。", "name": "widget_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "从父控件中移除控件，并调用unref函数销毁控件。\n\n> 一般无需直接调用，关闭窗口时，自动销毁相关控件。", "name": "widget_destroy_async", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "增加控件的引用计数。", "name": "widget_ref", "return": { "type": "widget_t*", "desc": "返回控件对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "减少控件的引用计数。引用计数为0时销毁控件。", "name": "widget_unref", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": { "scriptable": true }, "desc": "判断当前控件是否是keyboard。\n\n> keyboard收到pointer事件时，不会让当前控件失去焦点。\n\n在自定义软键盘时，将所有按钮放到一个容器当中，并设置为is_keyboard。\n\n```c\nwidget_set_prop_bool(group, WIDGET_PROP_IS_KEYBOARD, TRUE);\n```", "name": "widget_is_keyboard", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "画布对象。" }, { "type": "const char*", "name": "icon", "desc": "图标的名称。" }, { "type": "wstr_t*", "name": "text", "desc": "文字。" } ], "annotation": {}, "desc": "帮助子控件实现自己的绘制函数。", "name": "widget_paint_helper", "return": { "type": "ret_t", "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": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "画布对象。" }, { "type": "rect_t*", "name": "r", "desc": "矩形区域。" } ], "annotation": { "scriptable": true }, "desc": "根据控件的style绘制边框矩形。", "name": "widget_stroke_border_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "画布对象。" }, { "type": "rect_t*", "name": "r", "desc": "矩形区域。" }, { "type": "image_draw_type_t", "name": "draw_type", "desc": "图片缺省绘制方式。" } ], "annotation": { "scriptable": true }, "desc": "根据控件的style绘制背景矩形。", "name": "widget_fill_bg_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "画布对象。" }, { "type": "rect_t*", "name": "r", "desc": "矩形区域。" }, { "type": "image_draw_type_t", "name": "draw_type", "desc": "图片缺省绘制方式。" } ], "annotation": { "scriptable": true }, "desc": "根据控件的style绘制前景矩形。", "name": "widget_fill_fg_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "画布对象。" } ], "annotation": {}, "desc": "从widget的style中取出字体名称、大小和颜色数据，设置到canvas中。", "name": "widget_prepare_text_style", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "wchar_t*", "name": "text", "desc": "文本。" } ], "annotation": {}, "desc": "计算文本的宽度。\n字体由控件当前的状态和style决定。", "name": "widget_measure_text", "return": { "type": "float_t", "desc": "返回文本的宽度。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "event_t*", "name": "e", "desc": "事件对象。" } ], "annotation": {}, "desc": "递归分发事件到targe控件。", "name": "widget_dispatch_event_to_target_recursive", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "bool_t", "name": "is_local", "desc": "TRUE表示是相对与控件左上角的坐标，否则表示全局坐标。" } ], "annotation": {}, "desc": "判断一个点是否在控件内。", "name": "widget_is_point_in", "return": { "type": "bool_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "event_t*", "name": "e", "desc": "事件。" } ], "annotation": { "scriptable": true }, "desc": "递归的分发一个事件到所有target子控件。", "name": "widget_dispatch_to_target", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "event_t*", "name": "e", "desc": "事件。" } ], "annotation": { "scriptable": true }, "desc": "递归的分发一个事件到所有key_target子控件。", "name": "widget_dispatch_to_key_target", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" } ], "annotation": {}, "desc": "查找x/y坐标对应的子控件。", "name": "widget_find_target", "return": { "type": "widget*", "desc": "子控件或NULL。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "语言改变后，重新翻译控件上的文本(包括子控件)。", "name": "widget_re_translate_text", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" }, { "type": "widget_t*", "name": "parent", "desc": "widget的父控件。" }, { "type": "widget_vtable_t*", "name": "vt", "desc": "虚表。" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": {}, "desc": "初始化控件。仅在子类控件构造函数中使用。\n\n> 请用widget\\_create代替本函数。\n\n@depreated", "name": "widget_init", "return": { "type": "widget_t*", "desc": "widget对象本身。" } }, { "params": [ { "type": "widget_t*", "name": "parent", "desc": "widget的父控件。" }, { "type": "widget_vtable_t*", "name": "vt", "desc": "虚表。" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": {}, "desc": "创建控件。仅在子类控件构造函数中使用。", "name": "widget_create", "return": { "type": "widget_t*", "desc": "widget对象本身。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "让控件根据自己当前状态更新style。", "name": "widget_update_style", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "让控件及子控件根据自己当前状态更新style。", "name": "widget_update_style_recursive", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "递归的把父控件的key_target设置为自己。", "name": "widget_set_as_key_target", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "把焦点移动下一个控件。\n\n>widget必须是当前焦点控件。", "name": "widget_focus_next", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "把焦点移动前一个控件。\n\n>widget必须是当前焦点控件。", "name": "widget_focus_prev", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" }, { "type": "bool_t", "name": "active", "desc": "控件是否为当前项。" }, { "type": "bool_t", "name": "checked", "desc": "控件是否为选中项。" } ], "annotation": { "scriptable": true }, "desc": "把控件的状态转成获取style选要的状态，一般只在子类中使用。", "name": "widget_get_state_for_style", "return": { "type": "const char*", "desc": "返回状态值。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "检查控件是否是system bar类型。", "name": "widget_is_system_bar", "return": { "type": "bool_t", "desc": "返回FALSE表示不是，否则表示是。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "检查控件是否是普通窗口类型。", "name": "widget_is_normal_window", "return": { "type": "bool_t", "desc": "返回FALSE表示不是，否则表示是。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "检查控件是否是对话框类型。", "name": "widget_is_dialog", "return": { "type": "bool_t", "desc": "返回FALSE表示不是，否则表示是。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "检查控件是否是弹出窗口类型。", "name": "widget_is_popup", "return": { "type": "bool_t", "desc": "返回FALSE表示不是，否则表示是。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "检查控件弹出窗口控件是否已经打开了（而非挂起状态）。", "name": "widget_is_opened_popup", "return": { "type": "bool_t", "desc": "返回FALSE表示不是，否则表示是。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" } ], "annotation": { "scriptable": true }, "desc": "布局当前控件及子控件。", "name": "widget_layout", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "layout子控件。", "name": "widget_layout_children", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "params", "desc": "布局参数。" } ], "annotation": { "scriptable": true }, "desc": "设置控件自己的布局参数。", "name": "widget_set_self_layout", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "params", "desc": "布局参数。" } ], "annotation": { "scriptable": true }, "desc": "设置子控件的布局参数。", "name": "widget_set_children_layout", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "x", "desc": "x参数。" }, { "type": "const char*", "name": "y", "desc": "y参数。" }, { "type": "const char*", "name": "w", "desc": "w参数。" }, { "type": "const char*", "name": "h", "desc": "h参数。" } ], "annotation": { "scriptable": true }, "desc": "设置控件自己的布局(缺省布局器)参数(过时，请用widget\\_set\\_self\\_layout)。", "name": "widget_set_self_layout_params", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "state_and_name", "desc": "状态和名字，用英文的冒号分隔。" }, { "type": "int32_t", "name": "value", "desc": "值。" } ], "annotation": { "scriptable": true }, "desc": "设置整数类型的style。", "name": "widget_set_style_int", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "state_and_name", "desc": "状态和名字，用英文的冒号分隔。" }, { "type": "const char*", "name": "value", "desc": "值。" } ], "annotation": { "scriptable": true }, "desc": "设置字符串类型的style。", "name": "widget_set_style_str", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "state_and_name", "desc": "状态和名字，用英文的冒号分隔。" }, { "type": "uint32_t", "name": "value", "desc": "值。" } ], "annotation": { "scriptable": true }, "desc": "设置颜色类型的style。", "name": "widget_set_style_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "创建一个bitmap对象，将控件绘制到bitmap上，并返回bitmap对象。\n\n调用者需要调用bitmap_destroy销毁返回的bitmap对象。\n\n```c\nbitmap_t* bitmap = widget_take_snapshot(window_manager());\nbitmap_save_png(bitmap, \"test.png\");\nbitmap_destroy(bitmap);\n```", "name": "widget_take_snapshot", "return": { "type": "bitmap_t*", "desc": "返回位图对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "rect_t*", "name": "r", "desc": "截屏区域（输入NULL，则为控件全区域截屏）。" } ], "annotation": {}, "desc": "创建一个bitmap对象，将控件绘制到bitmap上并且可以设置该控件的截屏区域，返回bitmap对象。\n\n调用者需要调用bitmap_destroy销毁返回的bitmap对象。\n\n```c\nbitmap_t* bitmap = widget_take_snapshot_rect(window_manager(), NULL);\nbitmap_save_png(bitmap, \"test.png\");\nbitmap_destroy(bitmap);\n```", "name": "widget_take_snapshot_rect", "return": { "type": "bitmap_t*", "desc": "返回位图对象。" } }, { "params": [], "annotation": {}, "desc": "获取canvas对象。", "name": "widget_get_canvas", "return": { "type": "canvas_t*", "desc": "返回canvas对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "重置canvas对象。for designer only,调用者需要unload全部图片", "name": "widget_reset_canvas", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "canvas对象。" } ], "annotation": {}, "desc": "绘制背景。", "name": "widget_on_paint_background", "return": { "type": "ret_t", "desc": "返回。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "canvas对象。" } ], "annotation": {}, "desc": "绘制自身。", "name": "widget_on_paint_self", "return": { "type": "ret_t", "desc": "返回。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "canvas对象。" } ], "annotation": {}, "desc": "绘制子控件。", "name": "widget_on_paint_children", "return": { "type": "ret_t", "desc": "返回。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "canvas_t*", "name": "c", "desc": "canvas对象。" } ], "annotation": {}, "desc": "绘制边框。", "name": "widget_on_paint_border", "return": { "type": "ret_t", "desc": "返回。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "widget_vtable_t*", "name": "vt", "desc": "虚表。" } ], "annotation": {}, "desc": "检查控件是否是指定的类型。", "name": "widget_is_instance_of", "return": { "type": "bool_t", "desc": "返回TRUE表示是，FALSE表示否。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "设置控件需要relayout标识。", "name": "widget_set_need_relayout_children", "return": { "type": "ret_t", "desc": "返回。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "使控件滚动到可见区域。", "name": "widget_ensure_visible_in_viewport", "return": { "type": "ret_t", "desc": "返回。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "置焦点于第一个控件。", "name": "widget_focus_first", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "获取locale_info对象。", "name": "widget_get_locale_info", "return": { "type": "locale_info_t*", "desc": "返回locale_info对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "获取image_manager对象。", "name": "widget_get_image_manager", "return": { "type": "image_manager_t*", "desc": "返回image_manager对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "获取assets_manager对象。", "name": "widget_get_assets_manager", "return": { "type": "assets_manager_t*", "desc": "返回assets_manager对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "获取font_manager对象。", "name": "widget_get_font_manager", "return": { "type": "font_manager_t*", "desc": "返回font_manager对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "更新鼠标指针。", "name": "widget_update_pointer_cursor", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "ignore_user_input", "desc": "是否忽略用户输入。" } ], "annotation": {}, "desc": "开始等待鼠标指针。", "name": "widget_begin_wait_pointer_cursor", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" } ], "annotation": {}, "desc": "结束等待鼠标指针。", "name": "widget_end_wait_pointer_cursor", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "state_and_name", "desc": "样式对应类型与名字。" }, { "type": "const value_t*", "name": "value", "desc": "值。" } ], "annotation": {}, "desc": "设置widget私有样式。", "name": "widget_set_style", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。。" } }, { "params": [], "annotation": {}, "desc": "计算icon text的位置。", "name": "widget_calc_icon_text_rect", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" }, { "type": "str_t*", "name": "str", "desc": "用于保存xml结果。" } ], "annotation": {}, "desc": "将widget转换成xml。", "name": "widget_to_xml", "className": "widget_t", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [ { "name": "EVT_WILL_MOVE", "desc": "控件移动前触发。", "type": "event_t" }, { "name": "EVT_MOVE", "desc": "控件移动后触发。", "type": "event_t" }, { "name": "EVT_WILL_RESIZE", "desc": "控件调整大小前触发。", "type": "event_t" }, { "name": "EVT_RESIZE", "desc": "控件调整大小后触发。", "type": "event_t" }, { "name": "EVT_WILL_MOVE_RESIZE", "desc": "控件移动并调整大小前触发。", "type": "event_t" }, { "name": "EVT_MOVE_RESIZE", "desc": "控件移动并调整大小后触发。", "type": "event_t" }, { "name": "EVT_PROP_WILL_CHANGE", "desc": "控件属性改变前触发(通过set_prop设置属性，才会触发)。", "type": "prop_change_event_t" }, { "name": "EVT_PROP_CHANGED", "desc": "控件属性改变后触发(通过set_prop设置属性，才会触发)。", "type": "prop_change_event_t" }, { "name": "EVT_BEFORE_PAINT", "desc": "控件绘制前触发。", "type": "paint_event_t" }, { "name": "EVT_AFTER_PAINT", "desc": "控件绘制完成时触发。", "type": "paint_event_t" }, { "name": "EVT_FOCUS", "desc": "控件得到焦点时触发。", "type": "event_t" }, { "name": "EVT_BLUR", "desc": "控件失去焦点时触发。", "type": "event_t" }, { "name": "EVT_WHEEL", "desc": "鼠标滚轮事件。", "type": "wheel_event_t" }, { "name": "EVT_POINTER_LEAVE", "desc": "鼠标指针离开控件时触发。", "type": "pointer_event_t" }, { "name": "EVT_POINTER_ENTER", "desc": "鼠标指针进入控件时触发。", "type": "pointer_event_t" }, { "name": "EVT_KEY_DOWN", "desc": "键按下事件。", "type": "pointer_event_t" }, { "name": "EVT_KEY_UP", "desc": "键释放事件。", "type": "pointer_event_t" }, { "name": "EVT_POINTER_DOWN", "desc": "指针设备按下事件。", "type": "pointer_event_t" }, { "name": "EVT_POINTER_DOWN_ABORT", "desc": "取消指针设备按下事件。", "type": "pointer_event_t" }, { "name": "EVT_POINTER_MOVE", "desc": "指针设备移动事件。", "type": "pointer_event_t" }, { "name": "EVT_POINTER_UP", "desc": "指针设备释放事件。", "type": "pointer_event_t" }, { "name": "EVT_DESTROY", "desc": "控件销毁时触发。", "type": "event_t" } ], "properties": [ { "name": "x", "desc": "x坐标(相对于父控件的x坐标)。", "type": "xy_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "y", "desc": "y坐标(相对于父控件的y坐标)。", "type": "xy_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "w", "desc": "宽度。", "type": "wh_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "h", "desc": "高度。", "type": "wh_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "name", "desc": "控件名字。", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "pointer_cursor", "desc": "鼠标光标图片名称。", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "tr_text", "desc": "保存用于翻译的字符串。", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "style", "desc": "style的名称。", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "animation", "desc": "动画参数。请参考[控件动画](https://github.com/zlgopen/awtk/blob/master/docs/widget_animator.md)", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "enable", "desc": "启用/禁用状态。", "type": "bool_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "feedback", "desc": "是否启用按键音、触屏音和震动等反馈。", "type": "bool_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "visible", "desc": "是否可见。", "type": "bool_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "writable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "sensitive", "desc": "是否接受用户事件。", "type": "bool_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "writable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "focusable", "desc": "是否支持焦点停留。", "type": "bool_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "writable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "with_focus_state", "desc": "是否支持焦点状态。\n> 如果希望style支持焦点状态，但有不希望焦点停留，可用本属性。", "type": "bool_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "writable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "focused", "desc": "是否得到焦点。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "auto_created", "desc": "是否由父控件自动创建。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "dirty", "desc": "标识控件是否需要重绘。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "floating", "desc": "标识控件是否启用浮动布局，不受父控件的children_layout的控制。", "type": "bool_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "need_relayout_children", "desc": "标识控件是否需要重新layout子控件。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "need_update_style", "desc": "标识控件是否需要update style。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "ref_count", "desc": "引用计数，计数为0时销毁。", "type": "int32_t", "annotation": { "readable": true } }, { "name": "initializing", "desc": "标识控件正在初始化。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "loading", "desc": "标识控件正在加载。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "destroying", "desc": "标识控件正在被销毁。", "type": "bool_t", "annotation": { "readable": true } }, { "name": "state", "desc": "控件的状态(取值参考widget_state_t)。", "type": "uint8_t", "annotation": { "readable": true } }, { "name": "opacity", "desc": "不透明度(0-255)，0完全透明，255完全不透明。", "type": "uint8_t", "annotation": { "readable": true } }, { "name": "dirty_rect_tolerance", "desc": "脏矩形超出控件本身大小的最大范围(一般不用指定)。\n\n> 如果 border 太粗或 offset 太大等原因，导致脏矩形超出控件本身大小太多（大于缺省值）时，才需要指定。", "type": "uint16_t", "annotation": { "readable": true, "design": true, "scriptable": true } }, { "name": "text", "desc": "文本。用途视具体情况而定。", "type": "wstr_t", "annotation": { "readable": true } }, { "name": "parent", "desc": "父控件", "type": "widget_t*", "annotation": { "readable": true, "scriptable": true } }, { "name": "target", "desc": "接收事件的子控件。", "type": "widget_t*", "annotation": { "private": true } }, { "name": "grab_widget", "desc": "grab事件的子控件。", "type": "widget_t*", "annotation": { "private": true } }, { "name": "grab_widget_count", "desc": "有时子控件和控件自己都会grab widget，所需要grab的计数。", "type": "int32_t", "annotation": { "private": true } }, { "name": "key_target", "desc": "接收按键事件的子控件。", "type": "widget_t*", "annotation": { "private": true } }, { "name": "children", "desc": "全部子控件。", "type": "darray_t*", "annotation": { "readable": true } }, { "name": "emitter", "desc": "事件发射器。", "type": "emitter_t*", "annotation": { "readable": true } }, { "name": "astyle", "desc": "Style对象。", "type": "style_t*", "annotation": { "readable": true } }, { "name": "children_layout", "desc": "子控件布局器。请参考[控件布局参数](https://github.com/zlgopen/awtk/blob/master/docs/layout.md)", "type": "children_layouter_t*", "annotation": { "readable": true, "set_prop": true, "get_prop": true } }, { "name": "self_layout", "desc": "控件布局器。请参考[控件布局参数](https://github.com/zlgopen/awtk/blob/master/docs/layout.md)", "type": "self_layouter_t*", "annotation": { "readable": true, "set_prop": true, "get_prop": true } }, { "name": "custom_props", "desc": "自定义属性。", "type": "object_t*", "annotation": { "readable": true } }, { "name": "vt", "desc": "虚函数表。", "type": "widget_vtable_t", "annotation": { "readable": true } } ], "header": "base/widget.h", "desc": "**widget_t** 是所有控件、窗口和窗口管理器的基类。\n**widget_t**也是一个容器，可放其它**widget_t**到它的内部，形成一个树形结构。\n\n```graphviz\n[default_style]\n\nwidget_t -> widget_t[arrowhead = \"diamond\"]\nwindow_t -> widget_t[arrowhead = \"empty\"]\nwindow_manager_t -> widget_t[arrowhead = \"empty\"]\nbutton_t -> widget_t[arrowhead = \"empty\"]\nlabel_t -> widget_t[arrowhead = \"empty\"]\nxxx_widget_t -> widget_t[arrowhead = \"empty\"]\n```\n\n通常**widget_t**通过一个矩形区域向用户呈现一些信息，接受用户的输入，并据此做出适当的反应。\n它负责控件的生命周期、通用状态、事件分发和Style的管理。\n本类提供的接口(函数和属性)除非特别说明，一般都适用于子类控件。\n\n为了便于解释，这里特别说明一下几个术语：\n\n* **父控件与子控件**：父控件与子控件指的两个控件的组合关系(这是在运行时决定的)。\n比如：在窗口中放一个按钮，此时，我们称按钮是窗口的子控件，窗口是按钮的父控件。\n\n```graphviz\n[default_style]\n\n子控件 -> 父控件[arrowhead = \"ediamond\"]\n```\n\n* **子类控件与父类控件**：子类控件与父类控件指的两类控件的继承关系(这是在设计时决定的)。\n比如：我们称**button_t**是**widget_t**的子类控件，**widget_t**是**button_t**的父类控件。\n\n```graphviz\n[default_style]\n\n子类控件 -> 父类控件[arrowhead = \"empty\"]\n\n```\n\nwidget相关的函数都只能在GUI线程中执行，如果需在非GUI线程中想调用widget相关函数，\n请用idle\\_queue或timer\\_queue进行串行化。\n请参考[demo thread](https://github.com/zlgopen/awtk/blob/master/demos/demo_thread_app.c)\n\n**widget\\_t**是抽象类，不要直接创建**widget\\_t**的实例。控件支持两种创建方式：\n\n* 通过XML创建。如：\n\n```xml\n\n```\n\n拖动对话框标题时移动对话框：\n\n```xml\n\n\n\n```\n\n> 更多用法请参考：\n[draggable.xml](https://github.com/zlgopen/awtk/blob/master/demos/assets/default/raw/ui/draggable.xml)\n\n在c代码中使用函数draggable\\_create创建按钮控件。如：\n\n```c\nwidget_t* draggable = draggable_create(target, 0, 0, 0, 0);\n```\n\n> draggable本身不可见，故无需style。", "name": "draggable_t", "parent": "widget_t", "annotation": { "scriptable": true, "design": true, "widget": true }, "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "const char*", "name": "name", "desc": "窗口的缺省名称。" } ], "annotation": { "constructor": true }, "desc": "获取缺省的ui\\_builder对象。", "name": "ui_builder_default", "return": { "type": "ui_builder_t*", "desc": "返回ui\\_builder对象。" } } ], "events": [], "properties": [], "header": "ui_loader/ui_builder_default.h", "desc": "构建widget树。", "name": "ui_builder_default_t", "parent": "ui_builder_t", "annotation": { "fake": true }, "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "ui_binary_writer_t*", "name": "writer", "desc": "writer对象。" }, { "type": "wbuffer_t*", "name": "wbuffer", "desc": "保存结果的buffer。" } ], "annotation": { "constructor": true }, "desc": "初始化ui\\_binary\\_writer对象。", "name": "ui_binary_writer_init", "return": { "type": "ui_builder_t*", "desc": "返回ui\\_builder对象。" } } ], "events": [], "properties": [], "header": "ui_loader/ui_binary_writer.h", "desc": "生成二进制格式的UI描述数据。", "name": "ui_binary_writer_t", "parent": "ui_builder_t", "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "parent", "desc": "父控件" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": { "constructor": true, "scriptable": true }, "desc": "创建color_picker对象", "name": "color_picker_create", "return": { "type": "widget_t*", "desc": "对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "const char*", "name": "color", "desc": "颜色。" } ], "annotation": { "scriptable": true }, "desc": "设置颜色。", "name": "color_picker_set_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "color_picker对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为color_picker对象(供脚本语言使用)。", "name": "color_picker_cast", "return": { "type": "widget_t*", "desc": "color_picker对象。" } } ], "events": [ { "name": "EVT_VALUE_WILL_CHANGE", "desc": "值(颜色)即将改变事件。", "type": "event_t" }, { "name": "EVT_VALUE_CHANGED", "desc": "值(颜色)改变事件。", "type": "event_t" } ], "properties": [ { "name": "value", "desc": "颜色。", "type": "const char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } } ], "header": "color_picker/color_picker.h", "desc": "颜色选择器。\n\ncolor\\_picker\\_t是[widget\\_t](widget_t.md)的子类控件，widget\\_t的函数均适用于color\\_picker\\_t控件。\n\n在xml中使用\"color\\_picker\"标签创建颜色选择器控件。如：\n\n```xml\n\n\n\n\n\n\n```\n\n> 更多用法请参考：\n[color\\_picker](https://github.com/zlgopen/awtk/blob/master/demos/assets/default/raw/ui/color_picker.xml)\n\n其中的子控件必须按下列规则命名：\n\n* r 红色分量。可以是spin_box、edit和slider。\n* g 绿色分量。可以是spin_box、edit和slider。\n* b 蓝色分量。可以是spin_box、edit和slider。\n* h Hue分量。可以是spin_box、edit、slider和color_component。\n* s Saturation分量。可以是spin_box、edit和slider。\n* v Value/Brightness分量。可以是spin_box、edit和slider。\n* sv Saturation和Value/Brightness分量。可以是color_component。\n* old 旧的值。可以是spin_box、edit和color_tile。\n* new 新的值。可以是spin_box、edit和color_tile。", "name": "color_picker_t", "parent": "widget_t", "annotation": { "scriptable": true, "design": true, "widget": true }, "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "parent", "desc": "父控件" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": { "constructor": true }, "desc": "创建color_component对象", "name": "color_component_create", "return": { "type": "widget_t*", "desc": "对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "color_t", "name": "c", "desc": "颜色。" } ], "annotation": {}, "desc": "设置颜色。", "name": "color_component_set_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "float", "name": "h", "desc": "色调。" }, { "type": "float", "name": "s", "desc": "饱和度。" }, { "type": "float", "name": "v", "desc": "明度。" } ], "annotation": {}, "desc": "设置颜色。", "name": "color_component_set_hsv", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "color_component对象。" } ], "annotation": {}, "desc": "获取h分量。", "name": "color_component_get_h", "return": { "type": "float", "desc": "返回h分量。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "color_component对象。" } ], "annotation": {}, "desc": "获取s分量。", "name": "color_component_get_s", "return": { "type": "float", "desc": "返回s分量。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "color_component对象。" } ], "annotation": {}, "desc": "获取v分量。", "name": "color_component_get_v", "return": { "type": "float", "desc": "返回v分量。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "color_component对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为color_component对象(供脚本语言使用)。", "name": "color_component_cast", "return": { "type": "widget_t*", "desc": "color_component对象。" } } ], "events": [], "properties": [], "header": "color_picker/color_component.h", "desc": "颜色选择器的颜色分量。\n控件的名称有严格规定：\nCOLOR_PICKER_CHILD_SV: 水平为Value/Brightness(递增)，垂直为Saturation(递减)。\nCOLOR_PICKER_CHILD_H: 水平为同色，垂直为Hue(递减)。", "name": "color_component_t", "parent": "widget_t", "annotation": { "scriptable": true, "design": true, "widget": true }, "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "parent", "desc": "父控件" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": { "constructor": true, "scriptable": true }, "desc": "创建canvas_widget对象", "name": "canvas_widget_create", "return": { "type": "widget_t*", "desc": "对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "canvas_widget对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为canvas_widget对象(供脚本语言使用)。", "name": "canvas_widget_cast", "return": { "type": "widget_t*", "desc": "canvas_widget对象。" } } ], "events": [], "properties": [], "header": "canvas_widget/canvas_widget.h", "desc": "画布控件。\n\n画布控件让开发者可以自己在控件上绘制需要的内容。\n\ncanvas\\_widget\\_t是[widget\\_t](widget_t.md)的子类控件，widget\\_t的函数均适用于canvas\\_widget\\_t控件。\n\n在xml中使用\"canvas\"标签创建画布控件。如：\n\n```xml\n\n```\n\n> 更多用法请参考：\n[canvas_widget.xml](https://github.com/zlgopen/awtk/blob/master/demos/assets/default/raw/ui/vgcanvas.xml)\n\n在c代码中使用函数canvas\\_widget\\_create创建画布控件。如：\n\n```c\nwidget_t* canvas = canvas_widget_create(win, 0, 0, win->w, win->h);\n```\n\n> 创建之后，需要用widget\\_on注册EVT\\_PAINT事件，并在EVT\\_PAINT事件处理函数中绘制。\n\n```c\nwidget_on(canvas, EVT_PAINT, on_paint_event, canvas);\n```\n\n绘制时，可以通过canvas接口去绘制，也可以通过vgcanvas接口去绘制。\n先从evt获取canvas对象，再通过canvas\\_get\\_vgcanvas从canvas中获取vgcanvas对象。\n\n```c\n\nstatic ret_t on_paint_event(void* ctx, event_t* evt) {\nwidget_t* canvas_widget = WIDGET(ctx);\ncanvas_t* c = paint_event_cast(evt)->c;\nvgcanvas_t* vg = canvas_get_vgcanvas(c);\ncolor_t bg = color_init(0xe0, 0xe0, 0xe0, 0xff);\ncolor_t tc = color_init(0, 0, 0, 0xff);\nrect_t r = rect_init(canvas_widget->x, canvas_widget->y, canvas_widget->w, canvas_widget->h);\n\nvgcanvas_save(vg);\nvgcanvas_clip_rect(vg, r.x, r.y, r.w, r.h);\nvgcanvas_translate(vg, r.x, r.y);\n\n...\n\nvgcanvas_restore(vg);\n\nreturn RET_OK;\n}\n```\n\n> 完整示例请参考：\n[canvas demo](https://github.com/zlgopen/awtk-c-demos/blob/master/demos/canvas.c)\n\n参考：\n\n* [canvas接口描述](canvas_t.md)\n* [vgcanvas接口描述](vgcanvas_t.md)", "name": "canvas_widget_t", "parent": "widget_t", "annotation": { "scriptable": true, "design": true, "widget": true }, "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "event_t*", "name": "event", "desc": "event对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "把event对象转paint_event_t对象。主要给脚本语言使用。", "name": "paint_event_cast", "return": { "type": "paint_event_t*", "desc": "event 对象。" } }, { "params": [ { "type": "paint_event_t*", "name": "event", "desc": "event对象。" }, { "type": "void*", "name": "target", "desc": "事件目标。" }, { "type": "uint32_t", "name": "type", "desc": "事件类型。" }, { "type": "canvas_t*", "name": "c", "desc": "canvas对象。" } ], "annotation": {}, "desc": "初始化事件。", "name": "paint_event_init", "return": { "type": "event_t*", "desc": "event对象。" } } ], "events": [], "properties": [ { "name": "c", "desc": "canvas。", "type": "canvas_t*", "annotation": { "readable": true, "scriptable": true } } ], "header": "base/events.h", "desc": "绘制事件。", "name": "paint_event_t", "annotation": { "scriptable": true }, "parent": "event_t", "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "event_t*", "name": "event", "desc": "event对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "把event对象转window_event_t对象。主要给脚本语言使用。", "name": "window_event_cast", "return": { "type": "window_event_t*", "desc": "对象。" } }, { "params": [ { "type": "window_event_t*", "name": "event", "desc": "event对象。" }, { "type": "void*", "name": "target", "desc": "事件目标。" }, { "type": "uint32_t", "name": "type", "desc": "事件类型。" }, { "type": "widget_t*", "name": "widget", "desc": "window对象。" } ], "annotation": {}, "desc": "初始化事件。", "name": "window_event_init", "return": { "type": "event_t*", "desc": "event对象。" } }, { "params": [ { "type": "pointer_event_t*", "name": "evt", "desc": "指针事件对象。" }, { "type": "system_info_t*", "name": "info", "desc": "系统信息。" } ], "annotation": {}, "desc": "根据屏幕旋转方向修正pointer_event中的坐标。", "name": "pointer_event_rotate", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "window", "desc": "canvas。", "type": "widget_t*", "annotation": { "readable": true, "scriptable": true } } ], "header": "base/events.h", "desc": "窗口事件，由窗口管理器触发。", "name": "window_event_t", "annotation": { "scriptable": true }, "parent": "event_t", "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "widget", "desc": "image对象。" }, { "type": "char*", "name": "name", "desc": "图片名称，该图片必须存在于资源管理器。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的图片名称。\n\n> 如果需要显示文件系统中的图片，只需将图片名称换成实际的文件名，并加上\"file://\"前缀即可。", "name": "image_base_set_image", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "float_t", "name": "rotation", "desc": "旋转角度(幅度)。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的旋转角度(仅在WITH_VGCANVAS定义时生效)。", "name": "image_base_set_rotation", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "float_t", "name": "scale_x", "desc": "X方向缩放比例。" }, { "type": "float_t", "name": "scale_y", "desc": "Y方向缩放比例。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的缩放比例(仅在WITH_VGCANVAS定义时生效)。", "name": "image_base_set_scale", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "float_t", "name": "anchor_x", "desc": "锚点X(0-1)。0在控件左边，0.5在控件中间，1在控件右边。" }, { "type": "float_t", "name": "anchor_y", "desc": "锚点Y(0-1)。0在控件顶部，0.5在控件中间，1在控件底部。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的锚点(仅在WITH_VGCANVAS定义时生效)。", "name": "image_base_set_anchor", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "selected", "desc": "是否被选中。" } ], "annotation": { "scriptable": true }, "desc": "设置控件的选中状态。", "name": "image_base_set_selected", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "selectable", "desc": "是否可以被选中。" } ], "annotation": { "scriptable": true }, "desc": "设置控件是否可以被选中。", "name": "image_base_set_selectable", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件对象。" }, { "type": "bool_t", "name": "clickable", "desc": "是否可以被点击。" } ], "annotation": { "scriptable": true }, "desc": "设置控件是否可以被点击。", "name": "image_base_set_clickable", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "image_base对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为image_base对象(供脚本语言使用)。", "name": "image_base_cast", "return": { "type": "widget_t*", "desc": "image_base对象。" } } ], "events": [], "properties": [ { "name": "image", "desc": "图片的名称。", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "anchor_x", "desc": "锚点X(0-1)。0在控件左边，0.5在控件中间，1在控件右边。", "type": "float_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "anchor_y", "desc": "锚点Y(0-1)。0在控件顶部，0.5在控件中间，1在控件底部。", "type": "float_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "scale_x", "desc": "控件在X方向上的缩放比例。", "type": "float_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "scale_y", "desc": "控件在Y方向上的缩放比例。", "type": "float_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "rotation", "desc": "控件的旋转角度(幅度)。", "type": "float_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "clickable", "desc": "点击时，是否触发EVT_CLICK事件。", "type": "bool_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "selectable", "desc": "是否设置选中状态。", "type": "bool_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "selected", "desc": "当前是否被选中。", "type": "bool_t", "annotation": { "readable": true, "scriptable": true } } ], "header": "base/image_base.h", "desc": "图片控件基类。\n\n本类把图片相关控件的公共行为进行抽象，放到一起方便重用。目前已知的具体实现如下图：\n\n```graphviz\n[default_style]\n\nimage_t -> image_base_t[arrowhead = \"empty\"]\nsvg_image_t -> image_base_t[arrowhead = \"empty\"]\ngif_image_t -> image_base_t[arrowhead = \"empty\"]\n```\n\n> 本类是一个抽象类，不能进行实例化。请在应用程序中使用具体的类，如image\\_t。\n\n如果需要显示文件系统中的图片，只需将图片名称换成实际的文件名，并加上\"file://\"前缀即可。如：\n\n```\n\n\n\n```", "name": "image_base_t", "parent": "widget_t", "annotation": { "scriptable": true, "widget": true }, "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "im_commit_event_t*", "name": "e", "desc": "事件对象。" }, { "type": "const char*", "name": "text", "desc": "文本。" }, { "type": "bool_t", "name": "replace", "desc": "是否替代当前的内容。" } ], "annotation": {}, "desc": "初始化im_commit事件。", "name": "im_commit_event_init", "return": { "type": "event_t*", "desc": "返回事件对象。" } } ], "events": [], "properties": [ { "name": "text", "desc": "提交的文本。", "type": "char*", "annotation": { "readable": true } }, { "name": "replace;", "desc": "是否替换原来的文本。", "type": "bool_t", "annotation": { "readable": true } } ], "header": "base/input_method.h", "desc": "输入法提交输入的文本事件。", "name": "im_commit_event_t", "parent": "event_t", "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "compressor_options_t", "name": "options", "desc": "选项。" } ], "annotation": {}, "desc": "创建compressor对象。", "name": "compressor_miniz_create", "return": { "type": "compressor_t*", "desc": "返回compressor对象。" } } ], "events": [], "properties": [], "header": "compressors/compressor_miniz.h", "desc": "基于miniz实现的compressor接口。", "name": "compressor_miniz_t", "parent": "compressor_t", "annotation": { "fake": true }, "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "text", "desc": "软键盘上的action按钮显示的文本。", "type": "char*", "annotation": { "readable": true } }, { "name": "enable", "desc": "软键盘上的action按钮启用。", "type": "bool_t", "annotation": { "readable": true } } ], "header": "base/input_method.h", "desc": "设置软键盘上的action按钮的信息事件。", "name": "im_action_button_info_event_t", "parent": "event_t", "level": 2 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true, "scriptable": true, "cast": true }, "desc": "获取全局window_manager对象", "name": "window_manager", "alias": "window_manager_instance", "return": { "type": "widget_t*", "desc": "对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "window_manager对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为window_manager对象(供脚本语言使用)。", "name": "window_manager_cast", "return": { "type": "widget_t*", "desc": "window_manager对象。" } }, { "params": [ { "type": "window_manager_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": {}, "desc": "设置缺省的窗口管理器。", "name": "window_manager_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": { "scriptable": true }, "desc": "获取最上面的主窗口。", "name": "window_manager_get_top_main_window", "return": { "type": "widget_t*", "desc": "返回窗口对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": { "scriptable": true }, "desc": "获取最上面的窗口。", "name": "window_manager_get_top_window", "return": { "type": "widget_t*", "desc": "返回窗口对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": { "scriptable": true }, "desc": "获取前一个的窗口。", "name": "window_manager_get_prev_window", "return": { "type": "widget_t*", "desc": "返回窗口对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": { "scriptable": true }, "desc": "获取指针当前的X坐标。", "name": "window_manager_get_pointer_x", "return": { "type": "xy_t", "desc": "返回指针当前的X坐标。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": { "scriptable": true }, "desc": "获取指针当前的Y坐标。", "name": "window_manager_get_pointer_y", "return": { "type": "xy_t", "desc": "返回指针当前的X坐标。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": { "scriptable": true }, "desc": "获取指针当前是否按下。", "name": "window_manager_get_pointer_pressed", "return": { "type": "bool_t", "desc": "返回指针当前是否按下。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": { "scriptable": true }, "desc": "获取当前窗口动画是否正在播放。", "name": "window_manager_is_animating", "return": { "type": "bool_t", "desc": "返回TRUE表示正在播放，FALSE表示没有播放。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" }, { "type": "widget_t*", "name": "window", "desc": "窗口对象。" } ], "annotation": {}, "desc": "打开窗口。", "name": "window_manager_open_window", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": {}, "desc": "绘制。\n\n> 仅由主循环调用。", "name": "window_manager_paint", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" }, { "type": "event_t*", "name": "e", "desc": "事件对象。" } ], "annotation": {}, "desc": "分发输入事件。\n\n> 一般仅由主循环调用，特殊情况也可以用来注入事件。", "name": "window_manager_dispatch_input_event", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" }, { "type": "bool_t", "name": "show_fps", "desc": "是否显示FPS。" } ], "annotation": { "scriptable": true }, "desc": "设置是否显示FPS。", "name": "window_manager_set_show_fps", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" }, { "type": "uint32_t", "name": "screen_saver_time", "desc": "屏保时间(单位毫秒), 为0关闭屏保。" } ], "annotation": { "scriptable": true }, "desc": "设置屏保时间。", "name": "window_manager_set_screen_saver_time", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" }, { "type": "const char*", "name": "cursor", "desc": "图片名称(从图片管理器中加载)。" } ], "annotation": { "scriptable": true }, "desc": "设置鼠标指针。", "name": "window_manager_set_cursor", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": { "scriptable": true }, "desc": "请求关闭顶层窗口。\n\n> 如果顶层窗口时模态对话框，用DIALOG\\_QUIT\\_NONE调用dialog\\_quit。", "name": "window_manager_back", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": { "scriptable": true }, "desc": "回到主窗口，关闭之上的全部窗口。\n\n> 如果顶层窗口时模态对话框，用DIALOG\\_QUIT\\_NONE调用dialog\\_quit。", "name": "window_manager_back_to_home", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" }, { "type": "const char*", "name": "target", "desc": "目标窗口的名称。" } ], "annotation": { "scriptable": true }, "desc": "回到指定的窗口，关闭之上的全部窗口。\n\n> 如果顶层窗口时模态对话框，用DIALOG\\_QUIT\\_NONE调用dialog\\_quit。", "name": "window_manager_back_to", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" }, { "type": "event_t*", "name": "e", "desc": "事件。" }, { "type": "void*", "name": "handle", "desc": "native window句柄。" } ], "annotation": {}, "desc": "处理native window事件。", "name": "window_manager_dispatch_native_window_event", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" }, { "type": "bool_t", "name": "ignore_user_input", "desc": "是否忽略用户输入。" } ], "annotation": {}, "desc": "开始等待鼠标指针。", "name": "window_manager_begin_wait_pointer_cursor", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" } ], "annotation": {}, "desc": "结束等待鼠标指针。", "name": "window_manager_end_wait_pointer_cursor", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "窗口管理器对象。" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": { "scriptable": true }, "desc": "调整原生窗口的大小。", "name": "window_manager_resize", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/window_manager.h", "desc": "窗口管理器。", "name": "window_manager_t", "parent": "widget_t", "annotation": { "scriptable": true }, "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "int8_t", "annotation": { "readable": true } }, { "name": "min", "desc": "最小值。", "type": "int8_t", "annotation": { "readable": true } }, { "name": "max", "desc": "最大值。", "type": "int8_t", "annotation": { "readable": true } }, { "name": "step", "desc": "步长。", "type": "int8_t", "annotation": { "readable": true } }, { "name": "unit", "desc": "单位。", "type": "const char*", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "有符号8位整数类型属性描述。", "name": "value_desc_int8_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "uint8_t", "annotation": { "readable": true } }, { "name": "min", "desc": "最小值。", "type": "uint8_t", "annotation": { "readable": true } }, { "name": "max", "desc": "最大值。", "type": "uint8_t", "annotation": { "readable": true } }, { "name": "step", "desc": "步长。", "type": "uint8_t", "annotation": { "readable": true } }, { "name": "unit", "desc": "单位。", "type": "const char*", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "无符号8位整数类型属性描述。", "name": "value_desc_uint8_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "int16_t", "annotation": { "readable": true } }, { "name": "min", "desc": "最小值。", "type": "int16_t", "annotation": { "readable": true } }, { "name": "max", "desc": "最大值。", "type": "int16_t", "annotation": { "readable": true } }, { "name": "step", "desc": "步长。", "type": "int16_t", "annotation": { "readable": true } }, { "name": "unit", "desc": "单位。", "type": "const char*", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "有符号16位整数类型属性描述。", "name": "value_desc_int16_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "uint16_t", "annotation": { "readable": true } }, { "name": "min", "desc": "最小值。", "type": "uint16_t", "annotation": { "readable": true } }, { "name": "max", "desc": "最大值。", "type": "uint16_t", "annotation": { "readable": true } }, { "name": "step", "desc": "步长。", "type": "uint16_t", "annotation": { "readable": true } }, { "name": "unit", "desc": "单位。", "type": "const char*", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "无符号16位整数类型属性描述。", "name": "value_desc_uint16_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "int32_t", "annotation": { "readable": true } }, { "name": "min", "desc": "最小值。", "type": "int32_t", "annotation": { "readable": true } }, { "name": "max", "desc": "最大值。", "type": "int32_t", "annotation": { "readable": true } }, { "name": "step", "desc": "步长。", "type": "int32_t", "annotation": { "readable": true } }, { "name": "unit", "desc": "单位。", "type": "const char*", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "有符号32位整数类型属性描述。", "name": "value_desc_int32_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "min", "desc": "最小值。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "max", "desc": "最大值。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "step", "desc": "步长。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "unit", "desc": "单位。", "type": "const char*", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "无符号32位整数类型属性描述。", "name": "value_desc_uint32_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "int64_t", "annotation": { "readable": true } }, { "name": "min", "desc": "最小值。", "type": "int64_t", "annotation": { "readable": true } }, { "name": "max", "desc": "最大值。", "type": "int64_t", "annotation": { "readable": true } }, { "name": "step", "desc": "步长。", "type": "int64_t", "annotation": { "readable": true } }, { "name": "unit", "desc": "单位。", "type": "const char*", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "有符号64位整数类型属性描述。", "name": "value_desc_int64_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "uint64_t", "annotation": { "readable": true } }, { "name": "min", "desc": "最小值。", "type": "uint64_t", "annotation": { "readable": true } }, { "name": "max", "desc": "最大值。", "type": "uint64_t", "annotation": { "readable": true } }, { "name": "step", "desc": "步长。", "type": "uint64_t", "annotation": { "readable": true } }, { "name": "unit", "desc": "单位。", "type": "const char*", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "无符号64位整数类型属性描述。", "name": "value_desc_uint64_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "float", "annotation": { "readable": true } }, { "name": "min", "desc": "最小值。", "type": "float", "annotation": { "readable": true } }, { "name": "max", "desc": "最大值。", "type": "float", "annotation": { "readable": true } }, { "name": "step", "desc": "步长。", "type": "float_t", "annotation": { "readable": true } }, { "name": "unit", "desc": "单位。", "type": "const char*", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "单精度浮点数类型属性描述。", "name": "value_desc_float_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "double", "annotation": { "readable": true } }, { "name": "min", "desc": "最小值。", "type": "double", "annotation": { "readable": true } }, { "name": "max", "desc": "最大值。", "type": "double", "annotation": { "readable": true } }, { "name": "step", "desc": "步长。", "type": "double", "annotation": { "readable": true } }, { "name": "unit", "desc": "单位。", "type": "const char*", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "单精度浮点数类型属性描述。", "name": "value_desc_double_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "bool_t", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "布尔类型属性描述。", "name": "value_desc_bool_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "const char*", "annotation": { "readable": true } }, { "name": "min", "desc": "最小长度。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "max", "desc": "最大长度。", "type": "uint32_t", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "字符串类型属性描述。", "name": "value_desc_string_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "min", "desc": "最小长度。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "max", "desc": "最大长度。", "type": "uint32_t", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "二进制类型属性描述。", "name": "value_desc_binary_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "defvalue", "desc": "缺省值。", "type": "int32_t", "annotation": { "readable": true } }, { "name": "enums", "desc": "枚举值（每一项用英文冒号分隔值和名称）。", "type": "const char**", "annotation": { "readable": true } } ], "header": "tkc/value_desc.h", "desc": "整数枚举类型属性描述。", "name": "value_desc_int_enums_t", "parent": "value_desc_t", "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "widget", "desc": "window_base对象。" } ], "annotation": {}, "desc": "窗口on_destroy函数的缺省实现。", "name": "window_base_on_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "window_base对象。" }, { "type": "event_t*", "name": "e", "desc": "event对象。" } ], "annotation": {}, "desc": "窗口on_event函数的缺省实现。", "name": "window_base_on_event", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "window_base对象。" }, { "type": "canvas_t*", "name": "c", "desc": "canvas对象。" } ], "annotation": {}, "desc": "窗口on_paint_begin函数的缺省实现。", "name": "window_base_on_paint_begin", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "window_base对象。" }, { "type": "canvas_t*", "name": "c", "desc": "canvas对象。" } ], "annotation": {}, "desc": "窗口on_paint_end函数的缺省实现。", "name": "window_base_on_paint_end", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。1" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "window_base对象。" }, { "type": "canvas_t*", "name": "c", "desc": "canvas对象。" } ], "annotation": {}, "desc": "窗口on_paint_self函数的缺省实现。", "name": "window_base_on_paint_self", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "window_base对象。g" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "value_t*", "name": "v", "desc": "value对象" } ], "annotation": {}, "desc": "窗口get_prop函数的缺省实现。", "name": "window_base_get_prop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "window_base对象。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "const value_t*", "name": "v", "desc": "value对象" } ], "annotation": {}, "desc": "窗口set_prop函数的缺省实现。", "name": "window_base_set_prop", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "parent", "desc": "父控件" }, { "type": "const widget_vtable_t*", "name": "vt", "desc": "vtable对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": {}, "desc": "创建window base对象。", "name": "window_base_create", "return": { "type": "widget_t*", "desc": "窗口对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "window_base对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为window_base对象(供脚本语言使用)。", "name": "window_base_cast", "return": { "type": "widget_t*", "desc": "window_base对象。" } } ], "events": [], "properties": [ { "name": "theme", "desc": "主题资源的名称。\n每个窗口都可以有独立的主题文件，如果没指定，则使用系统缺省的主题文件。\n主题是一个XML文件，放在assets/raw/styles目录下。\n请参考[主题](https://github.com/zlgopen/awtk/blob/master/docs/theme.md)", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "disable_anim", "desc": "禁用窗口动画。", "type": "bool_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "closable", "desc": "收到EVT_REQUEST_CLOSE_WINDOW是否自动关闭窗口。\n\n如果关闭窗口时，需要用户确认:\n\n* 1.将closable设置为WINDOW\\_CLOSABLE\\_CONFIRM\n\n* 2.处理窗口的EVT\\_REQUEST\\_CLOSE\\_WINDOW事件\n\n> closable在XML中取值为：yes/no/confirm，缺省为yes。", "type": "window_closable_t", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "open_anim_hint", "desc": "打开窗口动画的名称。\n请参考[窗口动画](https://github.com/zlgopen/awtk/blob/master/docs/window_animator.md)", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "close_anim_hint", "desc": "关闭窗口动画的名称。\n请参考[窗口动画](https://github.com/zlgopen/awtk/blob/master/docs/window_animator.md)", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "stage", "desc": "窗口当前处于的状态。", "type": "char*", "annotation": { "readable": true, "get_prop": true } }, { "name": "theme_obj", "desc": "窗口的常量主题数据。\n\n>\n把主题管理器对象与窗口关联起来，是为了解决UI设计器与被设计的窗口需要从不同的位置加载主题资源的问题。", "type": "theme_t*", "annotation": { "get_prop": true } }, { "name": "image_manager", "desc": "获取图片管理器对象。\n\n>\n把图片管理器对象与窗口关联起来，是为了解决UI设计器与被设计的窗口需要从不同的位置加载图片资源的问题。", "type": "image_manager_t*", "annotation": { "get_prop": true } }, { "name": "font_manager", "desc": "获取字体管理器对象。\n\n>\n把字体管理器对象与窗口关联起来，是为了解决UI设计器与被设计的窗口需要从不同的位置加载字体资源的问题。", "type": "font_manager_t*", "annotation": { "get_prop": true } }, { "name": "assets_manager", "desc": "获取资源管理器对象。\n\n>\n把资源管理器对象与窗口关联起来，是为了解决UI设计器与被设计的窗口需要从不同的位置加载资源资源的问题。", "type": "assets_manager_t*", "annotation": { "get_prop": true } }, { "name": "move_focus_prev_key", "desc": "向前移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "move_focus_next_key", "desc": "向后移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "move_focus_up_key", "desc": "向上移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "move_focus_down_key", "desc": "向下移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "move_focus_left_key", "desc": "向左移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } }, { "name": "move_focus_right_key", "desc": "向右移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)", "type": "char*", "annotation": { "set_prop": true, "get_prop": true, "readable": true, "persitent": true, "design": true, "scriptable": true } } ], "header": "base/window_base.h", "desc": "窗口。\n\n本类把窗口相关的公共行为进行抽象，放到一起方便重用。目前已知的具体实现如下图：\n\n```graphviz\n[default_style]\n\nwindow_t -> window_base_t[arrowhead = \"empty\"]\npopup_t -> window_base_t[arrowhead = \"empty\"]\ndialog_t -> window_base_t[arrowhead = \"empty\"]\nsystem_bar_t -> window_base_t[arrowhead = \"empty\"]\ncalibration_win_t -> window_base_t[arrowhead = \"empty\"]\n```\n\n> 本类是一个抽象类，不能进行实例化。请在应用程序中使用具体的类，如window\\_t。", "name": "window_base_t", "parent": "widget_t", "annotation": { "scriptable": true, "widget": true }, "level": 2 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true }, "desc": "获取缺省的控件工厂对象。", "name": "widget_factory", "alias": "widget_factory_instance", "return": { "type": "widget_factory_t*", "desc": "返回控件工厂对象。" } }, { "params": [ { "type": "widget_factory_t*", "name": "factory", "desc": "控件工厂对象。" } ], "annotation": {}, "desc": "设置缺省的控件工厂对象。", "name": "widget_factory_set", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [], "annotation": { "constructor": true }, "desc": "创建控件工厂对象。", "name": "widget_factory_create", "return": { "type": "widget_factory_t*", "desc": "返回控件工厂对象。" } }, { "params": [ { "type": "widget_factory_t*", "name": "factory", "desc": "控件工厂对象。" }, { "type": "const char*", "name": "type", "desc": "控件类型。" }, { "type": "widget_create_t", "name": "create", "desc": "创建函数。" } ], "annotation": {}, "desc": "注册控件创建函数。", "name": "widget_factory_register", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_factory_t*", "name": "factory", "desc": "控件工厂对象。" }, { "type": "const char*", "name": "type", "desc": "控件类型。" }, { "type": "xy_t", "name": "x", "desc": "初始X坐标。" }, { "type": "xy_t", "name": "y", "desc": "初始Y坐标。" }, { "type": "xy_t", "name": "w", "desc": "初始宽度。" }, { "type": "xy_t", "name": "h", "desc": "初始高度。" } ], "annotation": { "constructor": true }, "desc": "创建指定类型的控件。", "name": "widget_factory_create_widget", "return": { "type": "widget_t*", "desc": "返回控件对象。" } }, { "params": [ { "type": "widget_factory_t*", "name": "factory", "desc": "控件工厂对象。" } ], "annotation": {}, "desc": "析构并释放控件工厂对象。", "name": "widget_factory_destroy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/widget_factory.h", "desc": "控件工厂对象。\n\n提供通过类型创建控件的能力。\n用户注册自定义控件，可以获得内置控件同等待遇。", "name": "widget_factory_t", "parent": "emitter", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [ { "name": "candidates", "desc": "可选的文本，多个文本以\\0分隔。如：里\\0李\\0力\\0离\\0", "type": "char*", "annotation": { "readable": true } }, { "name": "candidates_nr", "desc": "可选的文本的个数。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "selected;", "desc": "缺省选中某个候选字，小余0不选择任何候选字 。", "type": "int32_t", "annotation": { "readable": true } } ], "header": "base/input_method.h", "desc": "输入法请求显示候选字的事件。", "name": "im_candidates_event_t", "parent": "event_t", "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "const char*", "name": "name", "desc": "名称。" } ], "annotation": { "scriptable": true }, "desc": "设置style的名称。", "name": "style_mutable_set_name", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "const char*", "name": "state", "desc": "控件状态。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "uint32_t", "name": "val", "desc": "值。" } ], "annotation": { "scriptable": true }, "desc": "设置指定名称整数格式的值。", "name": "style_mutable_set_int", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "const char*", "name": "state", "desc": "控件状态。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "color_t", "name": "val", "desc": "值。" } ], "annotation": {}, "desc": "设置指定名称的颜色值。", "name": "style_mutable_set_color", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "const char*", "name": "state", "desc": "控件状态。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "const char*", "name": "val", "desc": "值。" } ], "annotation": {}, "desc": "设置指定名称字符串的值。", "name": "style_mutable_set_str", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "tk_on_style_item_t", "name": "on_style_item", "desc": "回调函数。" }, { "type": "void*", "name": "ctx", "desc": "回调函数的上下文。" } ], "annotation": {}, "desc": "遍历。对每项调用回调函数on\\_style\\_item。", "name": "style_mutable_foreach", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "const char*", "name": "state", "desc": "控件状态。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "const value_t*", "name": "v", "desc": "值。" } ], "annotation": {}, "desc": "获取指定名称的值。", "name": "style_mutable_get_value", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "const char*", "name": "state", "desc": "控件状态。" }, { "type": "const char*", "name": "name", "desc": "属性名。" }, { "type": "const value_t*", "name": "v", "desc": "值。" } ], "annotation": {}, "desc": "设置指定名称的值。", "name": "style_mutable_set_value", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" }, { "type": "style_t*", "name": "other", "desc": "style对象。" } ], "annotation": {}, "desc": "将other对象的数据拷贝到s对象。", "name": "style_mutable_copy", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" } ], "annotation": {}, "desc": "清空s对象。", "name": "style_mutable_reset", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "style_t*", "name": "s", "desc": "style对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为style_mutable对象。", "name": "style_mutable_cast", "return": { "type": "style_t*", "desc": "style对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "控件" }, { "type": "style_t*", "name": "default_style", "desc": "缺省的style。" } ], "annotation": { "constructor": true, "scriptable": true }, "desc": "创建style\\_mutable对象。\n\n> 除了测试程序外不需要直接调用，widget会通过style\\_factory\\_create创建。", "name": "style_mutable_create", "return": { "type": "style_t*", "desc": "style对象。" } }, { "params": [], "annotation": {}, "desc": "将自己注册到style\\_factory。", "name": "style_mutable_register", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [ { "name": "name", "desc": "名称。", "type": "char*", "annotation": { "readable": true, "scriptable": true } }, { "name": "widget", "desc": "与之关联的控件。", "type": "widget_t*", "annotation": { "private": true } }, { "name": "default_style", "desc": "缺省的style，在mutable中找不到时，再到default_style中找。", "type": "style_t*", "annotation": { "private": true } }, { "name": "styles", "desc": "控件在不同状态下的style。", "type": "widget_state_style_t*", "annotation": { "private": true } } ], "header": "base/style_mutable.h", "desc": "可变的style(可实时修改并生效，主要用于在designer中被编辑的控件，或者一些特殊控件)。\n\nstyle\\_mutable也对style\\_const进行了包装，当用户没修改某个值时，便从style\\_const中获取。", "name": "style_mutable_t", "parent": "style_t", "annotation": { "scriptable": true }, "level": 2 }, { "type": "class", "methods": [ { "params": [], "annotation": { "constructor": true }, "desc": "创建只读的style对象。", "name": "style_const_create", "return": { "type": "style_t*", "desc": "返回style对象。" } } ], "events": [], "properties": [], "header": "base/style_const.h", "desc": "只读的style，从theme\\_t中获取数据。\n\ntools/theme_gen用于把XML的主题数据转换成常量数据。", "name": "style_const_t", "parent": "style_t", "level": 2 }, { "type": "class", "methods": [], "events": [], "properties": [], "header": "base/lcd_profile.h", "desc": "对现有LCD对象进行包装，实现对各个函数的时间统计，用于辅助定位性能瓶颈。", "name": "lcd_profile_t", "parent": "lcd_t", "level": 2 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "parent", "desc": "父控件" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": { "constructor": true }, "desc": "创建calibration_win对象", "name": "calibration_win_create", "return": { "type": "widget_t*", "desc": "对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" }, { "type": "calibration_win_on_done_t", "name": "on_done", "desc": "回调函数。" }, { "type": "void*", "name": "ctx", "desc": "回调函数的上下文。" } ], "annotation": {}, "desc": "设置校准完成的处理函数。", "name": "calibration_win_set_on_done", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "widget对象。" }, { "type": "calibration_win_on_click_t", "name": "on_click", "desc": "回调函数。" }, { "type": "void*", "name": "ctx", "desc": "回调函数的上下文。" } ], "annotation": {}, "desc": "设置校准点击事件的处理函数。", "name": "calibration_win_set_on_click", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "calibration_win对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为calibration_win对象(供脚本语言使用)。", "name": "calibration_win_cast", "return": { "type": "widget_t*", "desc": "calibration_win对象。" } } ], "events": [], "properties": [], "header": "widgets/calibration_win.h", "desc": "电阻屏校准窗口。\n\ncalibration\\_win\\_t是[window\\_base\\_t](window_base_t.md)的子类控件，\nwindow\\_base\\_t的函数均适用于calibration\\_win\\_t控件。\n\n在xml中使用\"calibration\\_win\"标签创建电阻屏校准窗口。如：\n\n```xml\n\n\n```\n\n> 更多用法请参考：\n[window.xml](https://github.com/zlgopen/awtk/blob/master/demos/assets/default/raw/ui/calibration_win.xml)\n\n在c代码中使用函数calibration\\_win\\_create创建窗口。如：\n\n```c\nwidget_t* win = calibration_win_create(NULL, 0, 0, 320, 480);\n```\n\n通过calibration\\_win\\_set\\_on\\_done注册回调函数，用于保存校准数据。", "name": "calibration_win_t", "parent": "window_base_t", "annotation": { "scriptable": true, "design": true, "widget": true, "window": true }, "level": 3 }, { "type": "class", "methods": [ { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" }, { "type": "xy_t", "name": "x", "desc": "x坐标。" }, { "type": "xy_t", "name": "y", "desc": "y坐标。" }, { "type": "bool_t", "name": "force", "desc": "无论是否shared都move。" } ], "annotation": { "scriptable": true }, "desc": "移动窗口。", "name": "native_window_move", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" }, { "type": "wh_t", "name": "w", "desc": "宽。" }, { "type": "wh_t", "name": "h", "desc": "高。" }, { "type": "bool_t", "name": "force", "desc": "无论是否shared都resize。" } ], "annotation": { "scriptable": true }, "desc": "调整窗口大小。", "name": "native_window_resize", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" } ], "annotation": { "scriptable": true }, "desc": "最小化窗口。", "name": "native_window_minimize", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" } ], "annotation": { "scriptable": true }, "desc": "最大化窗口。", "name": "native_window_maximize", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" } ], "annotation": { "scriptable": true }, "desc": "恢复窗口大小。", "name": "native_window_restore", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" } ], "annotation": { "scriptable": true }, "desc": "窗口居中。", "name": "native_window_center", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" }, { "type": "bool_t", "name": "show", "desc": "是否显示。" } ], "annotation": { "scriptable": true }, "desc": "是否显示边框。", "name": "native_window_show_border", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" }, { "type": "bool_t", "name": "fullscreen", "desc": "是否全屏。" } ], "annotation": { "scriptable": true }, "desc": "是否全屏。", "name": "native_window_set_fullscreen", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" }, { "type": "const char*", "name": "name", "desc": "鼠标光标的名称。" }, { "type": "bitmap_t*", "name": "img", "desc": "鼠标光标的图片。" } ], "annotation": { "scriptable": true }, "desc": "设置鼠标光标。", "name": "native_window_set_cursor", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" } ], "annotation": {}, "desc": "获取canvas。", "name": "native_window_get_canvas", "return": { "type": "canvas_t", "desc": "返回canvas对象。" } }, { "params": [ { "type": "const char*", "name": "params", "desc": "参数。" } ], "annotation": {}, "desc": "创建win对象。", "name": "native_window_create", "return": { "type": "native_window_t*", "desc": "返回win对象。" } }, { "params": [ { "type": "native_window_t*", "name": "win", "desc": "win对象。" }, { "type": "rect_t*", "name": "r", "desc": "重绘区域。" } ], "annotation": {}, "desc": "请求重绘指定区域。", "name": "native_window_invalidate", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } } ], "events": [], "properties": [], "header": "base/native_window.h", "desc": "原生窗口。", "name": "native_window_t", "parent": "object_t", "annotation": { "scriptable": true }, "level": 3 }, { "type": "class", "methods": [ { "params": [ { "type": "const char*", "name": "url", "desc": "路径(通常是文件路径)。" }, { "type": "bool_t", "name": "create_if_not_exist", "desc": "如果不存在是否创建。" } ], "annotation": { "constructor": true }, "desc": "", "name": "conf_ini_load", "return": { "type": "object_t*", "desc": "返回配置对象。" } } ], "events": [], "properties": [], "header": "conf_io/conf_ini.h", "desc": "conf ini对象。", "name": "conf_ini_t", "parent": "object_t", "annotation": { "fake": true }, "level": 3 }, { "type": "class", "methods": [ { "params": [ { "type": "const char*", "name": "url", "desc": "路径(通常是文件路径)。" }, { "type": "bool_t", "name": "create_if_not_exist", "desc": "如果不存在是否创建。" } ], "annotation": { "constructor": true }, "desc": "", "name": "conf_json_load", "return": { "type": "object_t*", "desc": "返回配置对象。" } } ], "events": [], "properties": [], "header": "conf_io/conf_json.h", "desc": "conf json对象。", "name": "conf_json_t", "parent": "object_t", "annotation": { "fake": true }, "level": 3 }, { "type": "class", "methods": [ { "params": [ { "type": "conf_doc_save_t", "name": "save", "desc": "保存函数。" }, { "type": "conf_doc_load_t", "name": "load", "desc": "加载函数。" }, { "type": "const char*", "name": "url", "desc": "路径。" }, { "type": "bool_t", "name": "create_if_not_exist", "desc": "如果不存在是否创建。" } ], "annotation": { "constructor": true }, "desc": "", "name": "conf_obj_create", "return": { "type": "object_t*", "desc": "返回配置对象。" } }, { "params": [ { "type": "object_t*", "name": "conf", "desc": "conf对象。" } ], "annotation": {}, "desc": "获取doc对象，用于更高级的操作。", "name": "conf_obj_get_doc", "return": { "type": "conf_dot_t", "desc": "返回doc对象。" } }, { "params": [ { "type": "object_t*", "name": "conf", "desc": "conf对象。" } ], "annotation": {}, "desc": "保存文档。", "name": "conf_obj_save", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败" } }, { "params": [ { "type": "object_t*", "name": "conf", "desc": "conf对象。" }, { "type": "bool_t", "name": "readonly", "desc": "只读模式。" } ], "annotation": {}, "desc": "设置为只读模式。", "name": "conf_obj_set_readonly", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败" } } ], "events": [], "properties": [], "header": "conf_io/conf_obj.h", "desc": "conf对象。", "name": "conf_obj_t", "parent": "object_t", "annotation": { "fake": true }, "level": 3 }, { "type": "class", "methods": [ { "params": [ { "type": "const char*", "name": "url", "desc": "路径(通常是文件路径)。" }, { "type": "bool_t", "name": "create_if_not_exist", "desc": "如果不存在是否创建。" } ], "annotation": { "constructor": true }, "desc": "", "name": "conf_ubjson_load", "return": { "type": "object_t*", "desc": "返回配置对象。" } } ], "events": [], "properties": [], "header": "conf_io/conf_ubjson.h", "desc": "conf json对象。", "name": "conf_ubjson_t", "parent": "object_t", "annotation": { "fake": true }, "level": 3 }, { "type": "class", "methods": [ { "params": [ { "type": "timer_info_t*", "name": "timer", "desc": "timer_info对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为timer_info对象(供脚本语言使用)。", "name": "timer_info_cast", "return": { "type": "timer_info_t*", "desc": "timer_info对象。" } } ], "events": [], "properties": [ { "name": "on_timer", "desc": "定时器回调函数。", "type": "timer_func_t", "annotation": { "readable": true } }, { "name": "ctx", "desc": "定时器回调函数的上下文", "type": "void*", "annotation": { "readable": true, "scriptable": true } }, { "name": "id", "desc": "定时器的ID\n\n> 为TK\\_INVALID\\_ID时表示无效定时器。", "type": "uint32_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "now", "desc": "当前时间(相对时间，单位为毫秒)。", "type": "uint64_t", "annotation": { "readable": true, "scriptable": true } }, { "name": "start", "desc": "起始时间(相对时间，单位为毫秒)。", "type": "uint64_t", "annotation": { "readable": true } }, { "name": "duration", "desc": "时间间隔(单位为毫秒)。", "type": "uint32_t", "annotation": { "readable": true } }, { "name": "on_destroy", "desc": "定时器销毁时的回调函数。", "type": "tk_destroy_t", "annotation": { "readable": true } }, { "name": "on_destroy_ctx", "desc": "定时器销毁时的回调函数上下文。", "type": "void*", "annotation": { "readable": true } } ], "header": "tkc/timer_info.h", "desc": "单个定时器的信息。", "name": "timer_info_t", "parent": "object_t", "annotation": { "scriptable": true }, "level": 3 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "parent", "desc": "父控件" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": { "constructor": true, "scriptable": true }, "desc": "创建gif_image对象", "name": "gif_image_create", "return": { "type": "widget_t*", "desc": "对象。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "gif_image对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为gif_image对象(供脚本语言使用)。", "name": "gif_image_cast", "return": { "type": "widget_t*", "desc": "gif_image对象。" } } ], "events": [], "properties": [], "header": "gif_image/gif_image.h", "desc": "GIF图片控件。\n\n> 注意：GIF图片的尺寸大于控件大小时会自动缩小图片，但一般的嵌入式系统的硬件加速都不支持图片缩放，\n所以缩放图片会导致性能明显下降。如果性能不满意时，请确认一下GIF图片的尺寸是否小余控件大小。\n\ngif\\_image\\_t是[image\\_base\\_t](image_base_t.md)的子类控件，image\\_base\\_t的函数均适用于gif\\_image\\_t控件。\n\n在xml中使用\"gif\"标签创建GIF图片控件。如：\n\n```xml\n\n```\n\n>更多用法请参考：\n[gif\nimage](https://github.com/zlgopen/awtk/blob/master/demos/assets/default/raw/ui/gif_image.xml)\n\n在c代码中使用函数gif\\_image\\_create创建GIF图片控件。如：\n\n```c\nwidget_t* image = gif_image_create(win, 10, 10, 200, 200);\nimage_set_image(image, \"bee\");\n```\n\n> 创建之后:\n>\n> 需要用widget\\_set\\_image设置图片名称。\n\n> 完整示例请参考：[gif image demo](\nhttps://github.com/zlgopen/awtk-c-demos/blob/master/demos/gif_image.c)\n\n可用通过style来设置控件的显示风格，如背景和边框等。如：\n\n```xml\n\n\n\n```\n\n> 更多用法请参考：[theme default](\nhttps://github.com/zlgopen/awtk/blob/master/demos/assets/default/raw/styles/default.xml)", "name": "gif_image_t", "parent": "image_base_t", "annotation": { "scriptable": true, "design": true, "widget": true }, "level": 3 }, { "type": "class", "methods": [ { "params": [ { "type": "widget_t*", "name": "parent", "desc": "父控件" }, { "type": "xy_t", "name": "x", "desc": "x坐标" }, { "type": "xy_t", "name": "y", "desc": "y坐标" }, { "type": "wh_t", "name": "w", "desc": "宽度" }, { "type": "wh_t", "name": "h", "desc": "高度" } ], "annotation": { "constructor": true, "scriptable": true }, "desc": "创建keyboard对象", "name": "keyboard_create", "return": { "type": "widget_t*", "desc": "对象。" } }, { "params": [ { "type": "widget_t*", "name": "parent", "desc": "keyboard对象。" } ], "annotation": { "deconstructor": true }, "desc": "关闭keyboard窗口。", "name": "keyboard_close", "return": { "type": "ret_t", "desc": "返回RET_OK表示成功，否则表示失败。" } }, { "params": [ { "type": "widget_t*", "name": "widget", "desc": "keyboard对象。" } ], "annotation": { "cast": true, "scriptable": true }, "desc": "转换为keyboard对象(供脚本语言使用)。", "name": "keyboard_cast", "return": { "type": "widget_t*", "desc": "keyboard对象。" } } ], "events": [], "properties": [], "header": "keyboard/keyboard.h", "desc": "软键盘。\n\n软键盘是一个特殊的窗口，由编辑器通过输入法自动打开和关闭。\n\n这里介绍一下定制软键盘的方法：\n\n编辑器输入类型和软键盘UI资源文件的对应关系:\n\n| 输入类型 | 软键盘UI资源文件|\n|----------------|:---------------:|\n| INPUT\\_PHONE | kb\\_phone.xml |\n| INPUT\\_INT | kb\\_int.xml |\n| INPUT\\_FLOAT | kb\\_float.xml |\n| INPUT\\_UINT | kb\\_uint.xml |\n| INPUT\\_UFLOAT | kb\\_ufloat.xml |\n| INPUT\\_HEX | kb\\_hex.xml |\n| INPUT\\_EMAIL | kb\\_ascii.xml |\n| INPUT\\_PASSWORD | kb\\_ascii.xml |\n| INPUT\\_CUSTOM | 使用自定义的键盘 |\n| 其它 | kb\\_default.xml |\n\nkeyboard中按钮子控件的名称有些特殊要求：\n\n| 名称 | 功能 |\n|----------------|:---------------:|\n| return | 回车键 |\n| action | 定制按钮 |\n| backspace | 删除键 |\n| tab | tab键 |\n| space | 空格键 |\n| close | 关闭软键盘 |\n| back | 关闭当前窗口 |\n| back_to_home | 返回home窗口 |\n| 前缀key: | 键值 |\n| 前缀hard_key: | 模拟物理键盘 |\n| 前缀page: | 切换到页面 |\n| 前缀opt: | 多个字符选择一个，点击切换到下一个，超时提交字符(用于实现九宫格输入) |\n\n示例：\n\n* 按键\"a\"，提交输入法处理。\n\n```xml\n