awtk/tools/completion_gen/awtk_ui.json

1604 lines
39 KiB
JSON
Raw Normal View History

2020-10-07 09:42:38 +08:00
{
"widgets": [
{
"name": "widget",
"desc": "**widget_t** 是所有控件、窗口和窗口管理器的基类。",
"props": [
{
"name": "x",
"desc": "x坐标(相对于父控件的x坐标)。",
"type": "xy_t"
},
{
"name": "y",
"desc": "y坐标(相对于父控件的y坐标)。",
"type": "xy_t"
},
{
"name": "w",
"desc": "宽度。",
"type": "wh_t"
},
{
"name": "h",
"desc": "高度。",
"type": "wh_t"
},
{
"name": "name",
"desc": "控件名字。",
"type": "char*"
},
{
"name": "pointer_cursor",
"desc": "鼠标光标图片名称。",
"type": "char*"
},
{
"name": "tr_text",
"desc": "保存用于翻译的字符串。",
"type": "char*"
},
{
"name": "style",
"desc": "style的名称。",
"type": "char*"
},
{
"name": "animation",
"desc": "动画参数。请参考[控件动画](https://github.com/zlgopen/awtk/blob/master/docs/widget_animator.md)",
"type": "char*"
},
{
"name": "enable",
"desc": "启用/禁用状态。",
"type": "bool_t"
},
{
"name": "feedback",
"desc": "是否启用按键音、触屏音和震动等反馈。",
"type": "bool_t"
},
{
"name": "visible",
"desc": "是否可见。",
"type": "bool_t"
},
{
"name": "sensitive",
"desc": "是否接受用户事件。",
"type": "bool_t"
},
{
"name": "focusable",
"desc": "是否支持焦点停留。",
"type": "bool_t"
},
{
"name": "with_focus_state",
"desc": "是否支持焦点状态。\n> 如果希望style支持焦点状态但有不希望焦点停留可用本属性。",
"type": "bool_t"
},
{
"name": "floating",
"desc": "标识控件是否启用浮动布局不受父控件的children_layout的控制。",
"type": "bool_t"
},
{
"name": "dirty_rect_tolerance",
"desc": "脏矩形超出控件本身大小的最大范围(一般不用指定)。\n\n> 如果 border 太粗或 offset 太大等原因,导致脏矩形超出控件本身大小太多(大于缺省值)时,才需要指定。",
"type": "uint16_t"
}
]
},
{
"name": "guage_pointer",
"parent": "widget",
"desc": "仪表指针控件。",
"props": [
{
"name": "angle",
"desc": "指针角度。12点钟方向为0度顺时钟方向为正单位为度。",
"type": "int32_t"
},
{
"name": "image",
"desc": "指针图片。\n\n图片须垂直向上图片的中心点为旋转方向。",
"type": "char*"
},
{
"name": "anchor_x",
"desc": "图片旋转锚点x坐标。(后面加上px为像素点不加px为相对百分比坐标0.0f到1.0f)",
"type": "char*"
},
{
"name": "anchor_y",
"desc": "图片旋转锚点x坐标。(后面加上px为像素点不加px为相对百分比坐标0.0f到1.0f)",
"type": "char*"
}
]
},
{
"name": "view",
"parent": "widget",
"desc": "一个通用的容器控件。",
"props": [
{
"name": "default_focused_child",
"desc": "缺省获得焦点的子控件(可用控件名或类型)。\n\n> view作为pages/slideview的直接子控件才需要设置。\n> 正常情况下,一个窗口只能指定一个初始焦点。\n> 但是对于pages/slideview来说可能希望每一个页面都有一个初始焦点此时可用default\\_focused\\_child来指定。",
"type": "char*"
}
]
},
{
"name": "tab_control",
"parent": "widget",
"desc": "标签控件。",
"props": []
},
{
"name": "tab_button",
"parent": "widget",
"desc": "标签按钮控件。",
"props": [
{
"name": "value",
"desc": "值。",
"type": "bool_t"
},
{
"name": "load_ui",
"desc": "激活后加载的UI名字。",
"type": "char*"
},
{
"name": "active_icon",
"desc": "当前项的图标的名称。",
"type": "char*"
},
{
"name": "icon",
"desc": "非当前项的图标的名称。",
"type": "char*"
}
]
},
{
"name": "tab_button_group",
"parent": "widget",
"desc": "标签按钮分组控件。",
"props": [
{
"name": "compact",
"desc": "紧凑型排版子控件(缺省FALSE)。",
"type": "bool_t"
},
{
"name": "scrollable",
"desc": "是否支持滚动(缺省FALSE)。\n\n> 紧凑型排版子控件时才支持滚动。",
"type": "bool_t"
}
]
},
{
"name": "slider",
"parent": "widget",
"desc": "滑块控件。",
"props": [
{
"name": "value",
"desc": "值。",
"type": "double"
},
{
"name": "min",
"desc": "最小值。",
"type": "double"
},
{
"name": "max",
"desc": "最大值。",
"type": "double"
},
{
"name": "step",
"desc": "拖动的最小单位。",
"type": "double"
},
{
"name": "vertical",
"desc": "滑块的是否为垂直方向。",
"type": "bool_t"
},
{
"name": "bar_size",
"desc": "轴的宽度或高度单位像素为0表示为控件的宽度或高度的一半缺省为0。",
"type": "uint32_t"
},
{
"name": "dragger_size",
"desc": "滑块的宽度或高度单位像素缺省为10。",
"type": "uint32_t"
},
{
"name": "dragger_adapt_to_icon",
"desc": "滑块的宽度或高度是否与icon适应缺省为true。",
"type": "bool_t"
},
{
"name": "slide_with_bar",
"desc": "是否允许在轴上滑动来改变滑块位置缺省为FALSE。",
"type": "bool_t"
}
]
},
{
"name": "row",
"parent": "widget",
"desc": "row。一个简单的容器控件用于水平排列其子控件。",
"props": []
},
{
"name": "progress_bar",
"parent": "widget",
"desc": "进度条控件。",
"props": [
{
"name": "value",
"desc": "进度条的值[0-max]。",
"type": "float_t"
},
{
"name": "max",
"desc": "最大值(缺省为100)。",
"type": "float_t"
},
{
"name": "vertical",
"desc": "进度条的是否为垂直方向。",
"type": "bool_t"
},
{
"name": "show_text",
"desc": "是否显示文本。",
"type": "bool_t"
}
]
},
{
"name": "pages",
"parent": "widget",
"desc": "页面管理控件。",
"props": [
{
"name": "active",
"desc": "当前活跃的page。",
"type": "uint32_t"
}
]
},
{
"name": "label",
"parent": "widget",
"desc": "文本控件。用于显示一行或多行文本。",
"props": [
{
"name": "length",
"desc": "显示字符的个数(小余0时全部显示)。\n主要用于动态改变显示字符的个数来实现类似[拨号中...]的动画效果。",
"type": "int32_t"
}
]
},
{
"name": "group_box",
"parent": "widget",
"desc": "分组控件。",
"props": []
},
{
"name": "grid",
"parent": "widget",
"desc": "grid控件。一个简单的容器控件用于网格排列一组控件。",
"props": []
},
{
"name": "grid_item",
"parent": "widget",
"desc": "grid_item。一个简单的容器控件一般作为grid的子控件。",
"props": []
},
{
"name": "edit",
"parent": "widget",
"desc": "单行编辑器控件。",
"props": [
{
"name": "readonly",
"desc": "编辑器是否为只读。",
"type": "bool_t"
},
{
"name": "password_visible",
"desc": "密码是否可见。",
"type": "bool_t"
},
{
"name": "auto_fix",
"desc": "输入无效时,是否自动改正。",
"type": "bool_t"
},
{
"name": "select_none_when_focused",
"desc": "获得焦点时不选中文本。\n\n> 主要用于没有指针设备的情况,否则软键盘无法取消选中文本。",
"type": "bool_t"
},
{
"name": "open_im_when_focused",
"desc": "获得焦点时打开输入法。\n\n> 主要用于没有指针设备的情况,否则每次切换焦点时都打开输入法。",
"type": "bool_t"
},
{
"name": "close_im_when_blured",
"desc": "是否在失去焦点时关闭输入法(默认是)。",
"type": "bool_t"
},
{
"name": "top_margin",
"desc": "上边距。",
"type": "uint8_t"
},
{
"name": "bottom_margin",
"desc": "下边距。",
"type": "uint8_t"
},
{
"name": "left_margin",
"desc": "左边距。",
"type": "uint8_t"
},
{
"name": "right_margin",
"desc": "右边距。",
"type": "uint8_t"
},
{
"name": "tips",
"desc": "输入提示。",
"type": "char*"
},
{
"name": "tr_tips",
"desc": "保存用于翻译的提示信息。",
"type": "char*"
},
{
"name": "action_text",
"desc": "软键盘上action按钮的文本。内置取值有\n\n* next 将焦点切换到下一个控件。\n* done 完成,关闭软键盘。\n\n也可以使用其它文本比如send表示发送。这个需要自己实现相应的功能处理EVT\\_IM\\_ACTION事件即可。",
"type": "char*"
},
{
"name": "keyboard",
"desc": "自定义软键盘名称。AWTK优先查找keyboard属性设置的键盘文件名该键盘的XML文件需要在default\\raw\\ui目录下存在如果keyboard为空就找input_type设置的键盘类型",
"type": "char*"
},
{
"name": "input_type",
"desc": "输入类型。",
"type": "input_type_t"
},
{
"name": "min",
"desc": "最小值或最小长度。",
"type": "double"
},
{
"name": "max",
"desc": "最大值或最大长度。",
"type": "double"
},
{
"name": "step",
"desc": "步长。\n作为数值型编辑器时一次增加和减少时的数值。",
"type": "double"
},
{
"name": "cancelable",
"desc": "是否支持撤销编辑。如果为TRUE在失去焦点之前可以撤销所有修改(恢复获得焦点之前的内容)。\n\n> * 1.一般配合keyboard的\"cancel\"按钮使用。\n> * 2.为TRUE时如果内容有变化会设置编辑器的状态为changed所以此时编辑器需要支持changed状态的style。",
"type": "bool_t"
}
]
},
{
"name": "dragger",
"parent": "widget",
"desc": "dragger控件。",
"props": [
{
"name": "x_min",
"desc": "x坐标的最小值。",
"type": "xy_t"
},
{
"name": "y_min",
"desc": "y坐标的最小值。",
"type": "xy_t"
},
{
"name": "x_max",
"desc": "x坐标的最大值。",
"type": "xy_t"
},
{
"name": "y_max",
"desc": "y坐标的最大值。",
"type": "xy_t"
}
]
},
{
"name": "digit_clock",
"parent": "widget",
"desc": "数字时钟控件。",
"props": [
{
"name": "format",
"desc": "显示格式。\n\n* Y 代表年(完整显示)\n* M 代表月(1-12)\n* D 代表日(1-31)\n* h 代表时(0-23)\n* m 代表分(0-59)\n* s 代表秒(0-59)\n* w 代表星期(0-6)\n* W 代表星期的英文缩写(支持翻译)\n* YY 代表年(只显示末两位)\n* MM 代表月(01-12)\n* DD 代表日(01-31)\n* hh 代表时(00-23)\n* mm 代表分(00-59)\n* ss 代表秒(00-59)\n* MMM 代表月的英文缩写(支持翻译)\n\n如 日期时间为2018/11/12 9:10:20\n* \"Y/M/D\"显示为\"2018/11/12\"\n* \"Y-M-D\"显示为\"2018-11-12\"\n* \"Y-M-D h:m:s\"显示为\"2018-11-12 9:10:20\"\n* \"Y-M-D hh:mm:ss\"显示为\"2018-11-12 09:10:20\"",
"type": "char*"
}
]
},
{
"name": "dialog_title",
"parent": "widget",
"desc": "对话框标题控件。",
"props": []
},
{
"name": "dialog_client",
"parent": "widget",
"desc": "对话框客户区控件。",
"props": []
},
{
"name": "combo_box_item",
"parent": "widget",
"desc": "ComboBox Item控件。",
"props": [
{
"name": "value",
"desc": "值。",
"type": "int32_t"
},
{
"name": "checked",
"desc": "是否被选中。",
"type": "bool_t"
}
]
},
{
"name": "time_clock",
"parent": "widget",
"desc": "模拟时钟控件。",
"props": [
{
"name": "hour",
"desc": "小时。",
"type": "int32_t"
},
{
"name": "minute",
"desc": "分钟。",
"type": "int32_t"
},
{
"name": "second",
"desc": "秒。",
"type": "int32_t"
},
{
"name": "image",
"desc": "中心图片。",
"type": "char*"
},
{
"name": "bg_image",
"desc": "背景图片。",
"type": "char*"
},
{
"name": "hour_image",
"desc": "时针图片。",
"type": "char*"
},
{
"name": "minute_image",
"desc": "分针图片。",
"type": "char*"
},
{
"name": "second_image",
"desc": "秒针图片。",
"type": "char*"
},
{
"name": "hour_anchor_x",
"desc": "时针图片旋转锚点x坐标。(后面加上px为像素点不加px为相对百分比坐标0.0f到1.0f)",
"type": "char*"
},
{
"name": "hour_anchor_y",
"desc": "时针图片旋转锚点y坐标。(后面加上px为像素点不加px为相对百分比坐标0.0f到1.0f)",
"type": "char*"
},
{
"name": "minute_anchor_x",
"desc": "分针图片旋转锚点x坐标。(后面加上px为像素点不加px为相对百分比坐标0.0f到1.0f)",
"type": "char*"
},
{
"name": "minute_anchor_y",
"desc": "分针图片旋转锚点y坐标。(后面加上px为像素点不加px为相对百分比坐标0.0f到1.0f)",
"type": "char*"
},
{
"name": "second_anchor_x",
"desc": "秒针图片旋转锚点x坐标。(后面加上px为像素点不加px为相对百分比坐标0.0f到1.0f)",
"type": "char*"
},
{
"name": "second_anchor_y",
"desc": "秒针图片旋转锚点y坐标。(后面加上px为像素点不加px为相对百分比坐标0.0f到1.0f)",
"type": "char*"
}
]
},
{
"name": "text_selector",
"parent": "widget",
"desc": "文本选择器控件,通常用于选择日期和时间等。",
"props": [
{
"name": "visible_nr",
"desc": "可见的选项数量(只能是3或者5缺省为5)。",
"type": "uint32_t"
},
{
"name": "selected_index",
"desc": "当前选中的选项。",
"type": "int32_t"
},
{
"name": "options",
"desc": "设置可选项(冒号分隔值和文本,分号分隔选项,如:1:red;2:green;3:blue)。\n对于数值选项也可以指定一个范围用『-』分隔起始值、结束值和格式。\n如\"1-7-%02d\"表示1到7格式为『02d』格式为可选缺省为『%d』。",
"type": "char*"
}
]
},
{
"name": "switch",
"parent": "widget",
"desc": "开关控件。",
"props": [
{
"name": "value",
"desc": "值。",
"type": "bool_t"
},
{
"name": "max_xoffset_ratio",
"desc": "当开关处于关闭时,图片偏移相对于图片宽度的比例(缺省为1/3)。",
"type": "float_t"
}
]
},
{
"name": "column",
"parent": "widget",
"desc": "column。一个简单的容器控件垂直排列其子控件。",
"props": []
},
{
"name": "color_tile",
"parent": "widget",
"desc": "色块控件。",
"props": [
{
"name": "bg_color",
"desc": "背景颜色。",
"type": "const char*"
},
{
"name": "border_color",
"desc": "边框颜色。",
"type": "const char*"
}
]
},
{
"name": "slide_view",
"parent": "widget",
"desc": "滑动视图。",
"props": [
{
"name": "vertical",
"desc": "是否为上下滑动模式。",
"type": "bool_t"
},
{
"name": "auto_play",
"desc": "自动播放。0表示禁止自动播放非0表示自动播放时每一页播放的时间。",
"type": "uint16_t"
},
{
"name": "loop",
"desc": "循环切换模式。\n\n向后切换切换到最后一页时再往后切换就到第一页。\n向前切换切换到第一页时再往前切换就到最后一页。",
"type": "bool_t"
},
{
"name": "anim_hint",
"desc": "页面切换效果。",
"type": "char*"
}
]
},
{
"name": "clip_view",
"parent": "widget",
"desc": "一个裁剪子控件的容器控件。",
"props": []
},
{
"name": "check_button",
"parent": "widget",
"desc": "勾选按钮控件(单选/多选)。",
"props": [
{
"name": "value",
"desc": "值(勾选为TRUE非勾选为FALSE)。",
"type": "bool_t"
}
]
},
{
"name": "slide_indicator",
"parent": "widget",
"desc": "slide_view的指示器控件。",
"props": [
{
"name": "value",
"desc": "值(缺省为0)。",
"type": "uint32_t"
},
{
"name": "max",
"desc": "最大值(缺省为100)。",
"type": "uint32_t"
},
{
"name": "default_paint",
"desc": "指示器的类型。",
"type": "indicator_default_paint_t"
},
{
"name": "auto_hide",
"desc": "自动隐藏。0表示禁止非0表示无操作后延迟多久隐藏。",
"type": "uint16_t"
},
{
"name": "margin",
"desc": "指示器与边缘的边距。",
"type": "int32_t"
},
{
"name": "spacing",
"desc": "指示器的中心之间的间距(圆弧显示时,间距的单位为弧度,否则为像素)。",
"type": "float_t"
},
{
"name": "size",
"desc": "指示器的大小。",
"type": "uint32_t"
},
{
"name": "anchor_x",
"desc": "锚点x坐标。",
"type": "float_t"
},
{
"name": "anchor_y",
"desc": "锚点y坐标。",
"type": "float_t"
},
{
"name": "indicated_target",
"desc": "指示器指示的目标。",
"type": "char*"
}
]
},
{
"name": "slide_menu",
"parent": "widget",
"desc": "左右滑动菜单控件。",
"props": [
{
"name": "value",
"desc": "值。代表当前选中项的索引。",
"type": "int32_t"
},
{
"name": "align_v",
"desc": "垂直对齐方式。",
"type": "align_v_t"
},
{
"name": "min_scale",
"desc": "最小缩放比例。",
"type": "float_t"
}
]
},
{
"name": "scroll_view",
"parent": "widget",
"desc": "滚动视图。",
"props": [
{
"name": "virtual_w",
"desc": "虚拟宽度。",
"type": "wh_t"
},
{
"name": "virtual_h",
"desc": "虚拟高度。",
"type": "wh_t"
},
{
"name": "xoffset",
"desc": "x偏移量。",
"type": "int32_t"
},
{
"name": "yoffset",
"desc": "y偏移量。",
"type": "int32_t"
},
{
"name": "xspeed_scale",
"desc": "x偏移速度比例。",
"type": "float_t"
},
{
"name": "yspeed_scale",
"desc": "y偏移速度比例。",
"type": "float_t"
},
{
"name": "xslidable",
"desc": "是否允许x方向滑动。",
"type": "bool_t"
},
{
"name": "yslidable",
"desc": "是否允许y方向滑动。",
"type": "bool_t"
}
]
},
{
"name": "scroll_bar",
"parent": "widget",
"desc": "滚动条控件。",
"props": [
{
"name": "virtual_size",
"desc": "虚拟宽度或高度。",
"type": "int32_t"
},
{
"name": "value",
"desc": "当前的值。",
"type": "int32_t"
},
{
"name": "row",
"desc": "行的高度。",
"type": "int32_t"
},
{
"name": "animatable",
"desc": "滚动时是否启用动画。",
"type": "bool_t"
}
]
},
{
"name": "list_view",
"parent": "widget",
"desc": "列表视图控件。",
"props": [
{
"name": "item_height",
"desc": "列表项的高度。如果 item_height > 0所有列表项使用固定高度否则使用列表项自身的高度。",
"type": "int32_t"
},
{
"name": "default_item_height",
"desc": "列表项的缺省高度。如果item_height <= 0 而且列表项自身的高度 <= 0则使用缺省高度。",
"type": "int32_t"
},
{
"name": "auto_hide_scroll_bar",
"desc": "如果不需要滚动条时,自动隐藏滚动条。",
"type": "bool_t"
}
]
},
{
"name": "list_view_h",
"parent": "widget",
"desc": "水平列表视图控件。",
"props": [
{
"name": "item_width",
"desc": "列表项的宽度。",
"type": "int32_t"
},
{
"name": "spacing",
"desc": "间距。",
"type": "int32_t"
}
]
},
{
"name": "list_item",
"parent": "widget",
"desc": "列表项控件。",
"props": []
},
{
"name": "hscroll_label",
"parent": "widget",
"desc": "可水平滚动的文本控件,方便实现长文本滚动。",
"props": [
{
"name": "only_focus",
"desc": "只有处于focus时才滚动(缺省否)。",
"type": "bool_t"
},
{
"name": "only_parent_focus",
"desc": "只有父控件处于focus时才滚动(缺省否)。",
"type": "bool_t"
},
{
"name": "loop",
"desc": "loop是否循环滚动(缺省FALSE)。",
"type": "bool_t"
},
{
"name": "yoyo",
"desc": "是否往返滚动(缺省FALSE)。",
"type": "bool_t"
},
{
"name": "ellipses",
"desc": "文本显示不下时,在行尾显示省略号(缺省FALSE)。",
"type": "bool_t"
},
{
"name": "lull",
"desc": "滚动之间的间歇时间(ms)缺省3000ms。",
"type": "int32_t"
}
]
},
{
"name": "button",
"parent": "widget",
"desc": "按钮控件。",
"props": [
{
"name": "repeat",
"desc": "重复触发EVT\\_CLICK事件的时间间隔。\n\n为0则不重复触发EVT\\_CLICK事件。",
"type": "int32_t"
},
{
"name": "enable_long_press",
"desc": "是否启用长按事件为true时才触发长按事件。\n\n触发长按事件后不再触发点击事件。\n缺省不启用。",
"type": "bool_t"
},
{
"name": "long_press_time",
"desc": "触发长按事件的时间(ms)",
"type": "uint32_t"
}
]
},
{
"name": "button_group",
"parent": "widget",
"desc": "Button Group控件。一个简单的容器控件用于容纳一组按钮控件。",
"props": []
},
{
"name": "app_bar",
"parent": "widget",
"desc": "app_bar控件。",
"props": []
},
{
"name": "rich_text",
"parent": "widget",
"desc": "图文混排控件,实现简单的图文混排。",
"props": [
{
"name": "line_gap",
"desc": "行间距。",
"type": "uint32_t"
},
{
"name": "margin",
"desc": "边距。",
"type": "uint32_t"
},
{
"name": "yslidable",
"desc": "标识控件是否允许上下拖动。",
"type": "bool_t"
}
]
},
{
"name": "rich_text_view",
"parent": "widget",
"desc": "rich_text_view是一个专用容器用来放rich text和 scroll bar并在两者之间建立联系。",
"props": []
},
{
"name": "progress_circle",
"parent": "widget",
"desc": "进度圆环控件。",
"props": [
{
"name": "value",
"desc": "值(缺省为0)。",
"type": "float_t"
},
{
"name": "max",
"desc": "最大值(缺省为100)。",
"type": "uint32_t"
},
{
"name": "start_angle",
"desc": "起始角度(单位为度,缺省-90)。",
"type": "int32_t"
},
{
"name": "line_width",
"desc": "环线的厚度(缺省为8)。",
"type": "uint32_t"
},
{
"name": "unit",
"desc": "单元(缺省无)。",
"type": "char*"
},
{
"name": "line_cap",
"desc": "线帽类型(round:圆头square:方头)。",
"type": "char*"
},
{
"name": "counter_clock_wise",
"desc": "是否为逆时针方向(缺省为FALSE)。",
"type": "bool_t"
},
{
"name": "show_text",
"desc": "是否显示文本(缺省为TRUE)。",
"type": "bool_t"
}
]
},
{
"name": "mledit",
"parent": "widget",
"desc": "多行编辑器控件。",
"props": [
{
"name": "readonly",
"desc": "编辑器是否为只读。",
"type": "bool_t"
},
{
"name": "top_margin",
"desc": "上边距。",
"type": "uint8_t"
},
{
"name": "bottom_margin",
"desc": "下边距。",
"type": "uint8_t"
},
{
"name": "left_margin",
"desc": "左边距。",
"type": "uint8_t"
},
{
"name": "right_margin",
"desc": "右边距。",
"type": "uint8_t"
},
{
"name": "tips",
"desc": "输入提示。",
"type": "char*"
},
{
"name": "tr_tips",
"desc": "保存用于翻译的提示信息。",
"type": "char*"
},
{
"name": "keyboard",
"desc": "自定义软键盘名称。",
"type": "char*"
},
{
"name": "wrap_word",
"desc": "是否自动折行。",
"type": "bool_t"
},
{
"name": "max_lines",
"desc": "最大行数。",
"type": "uint32_t"
},
{
"name": "scroll_line",
"desc": "鼠标一次滚动行数。",
"type": "uint32_t"
},
{
"name": "cancelable",
"desc": "是否支持撤销编辑。如果为TRUE在失去焦点之前可以撤销所有修改(恢复获得焦点之前的内容)。\n\n> * 1.一般配合keyboard的\"cancel\"按钮使用。\n> * 2.为TRUE时如果内容有变化会设置编辑器的状态为changed所以此时编辑器需要支持changed状态的style。",
"type": "bool_t"
},
{
"name": "open_im_when_focused",
"desc": "获得焦点时打开输入法。\n\n> 主要用于没有指针设备的情况,否则每次切换焦点时都打开输入法。",
"type": "bool_t"
},
{
"name": "close_im_when_blured",
"desc": "是否在失去焦点时关闭输入法(默认是)。",
"type": "bool_t"
}
]
},
{
"name": "line_number",
"parent": "widget",
"desc": "行号。多行编辑器的行号。",
"props": []
},
{
"name": "lang_indicator",
"parent": "widget",
"desc": "输入法语言指示器。",
"props": [
{
"name": "image",
"desc": "如果希望用图片格式显示,本属性用于指定图片的前缀。",
"type": "char*"
}
]
},
{
"name": "candidates",
"parent": "widget",
"desc": "输入法候选字词控件。",
"props": [
{
"name": "pre",
"desc": "是否为预候选字。\n\n> 预候选字: 在有的输入法中比如T9硬键盘输入时按下12两个键时预候选字会显示可用的拼音列表。\n> 从预候选字列表中选择拼音,再查询拼音对应的候选字列表。",
"type": "bool_t"
},
{
"name": "select_by_num",
"desc": "是否启用用数字选择候选字。比如按下1选择第1个候选字按下2选择第2个候选字。",
"type": "bool_t"
},
{
"name": "auto_hide",
"desc": "没有候选字时,是否自动隐藏控件。",
"type": "bool_t"
},
{
"name": "button_style",
"desc": "按钮的style名称。",
"type": "char*"
}
]
},
{
"name": "image_value",
"parent": "widget",
"desc": "图片值控件。",
"props": [
{
"name": "image",
"desc": "图片名称的前缀。",
"type": "char*"
},
{
"name": "format",
"desc": "数值到字符串转换时的格式,缺省为\"%d\"。",
"type": "char*"
},
{
"name": "click_add_delta",
"desc": "点击时加上一个增量。",
"type": "float_t"
},
{
"name": "value",
"desc": "值。",
"type": "float_t"
},
{
"name": "min",
"desc": "最小值(如果设置了click\\_add\\_delta到达最小值后回到最大值)。",
"type": "float_t"
},
{
"name": "max",
"desc": "最大值(如果设置了click\\_add\\_delta到达最大值后回到最小值)。",
"type": "float_t"
}
]
},
{
"name": "image_animation",
"parent": "widget",
"desc": "图片动画控件,指定一个图片前缀,依次显示指定序列的图片,从而形成动画效果。",
"props": [
{
"name": "image",
"desc": "图片名称的前缀。",
"type": "char*"
},
{
"name": "sequence",
"desc": "播放的序列字符可选值为数字和英文大小写字母字符可以重复。如0123456789或者123123abcd。",
"type": "char*"
},
{
"name": "start_index",
"desc": "图片起始序数。",
"type": "uint32_t"
},
{
"name": "end_index",
"desc": "图片结束序数。",
"type": "uint32_t"
},
{
"name": "loop",
"desc": "是否循环播放。",
"type": "bool_t"
},
{
"name": "auto_play",
"desc": "是否自动播放。",
"type": "bool_t"
},
{
"name": "unload_after_paint",
"desc": "绘制完成后unload图片以释放内存空间。",
"type": "bool_t"
},
{
"name": "format",
"desc": "索引到图片名转换时的格式,缺省为\"%s%d\"。",
"type": "char*"
},
{
"name": "interval",
"desc": "每张图片播放的时间(毫秒)。",
"type": "uint32_t"
},
{
"name": "delay",
"desc": "自动播放时延迟播放的时间(毫秒)。",
"type": "uint32_t"
}
]
},
{
"name": "guage",
"parent": "widget",
"desc": "表盘控件。",
"props": [
{
"name": "image",
"desc": "背景图片。",
"type": "char*"
},
{
"name": "draw_type",
"desc": "图片的绘制方式。",
"type": "image_draw_type_t"
}
]
},
{
"name": "file_browser_view",
"parent": "widget",
"desc": "文件管理/浏览/选择控件。",
"props": [
{
"name": "init_dir",
"desc": "初始文件夹。",
"type": "char*"
},
{
"name": "filter",
"desc": "过滤规则。",
"type": "char*"
},
{
"name": "ignore_hidden_files",
"desc": "是否忽略隐藏文件。",
"type": "bool_t"
},
{
"name": "sort_ascending",
"desc": "是否为升序排序。",
"type": "bool_t"
},
{
"name": "show_check_button",
"desc": "是否显示checkbutton。",
"type": "bool_t"
},
{
"name": "sort_by",
"desc": "排序方式。可选值(name, size, mtime, type)。",
"type": "char*"
}
]
},
{
"name": "draggable",
"parent": "widget",
"desc": "将draggable放入目标控件即可让目标控件或当前窗口可以被拖动。",
"props": [
{
"name": "top",
"desc": "拖动范围的顶部限制。缺省为父控件的顶部。",
"type": "int32_t"
},
{
"name": "bottom",
"desc": "拖动范围的底部限制。缺省为父控件的底部。",
"type": "int32_t"
},
{
"name": "left",
"desc": "拖动范围的左边限制。缺省为父控件的左边。",
"type": "int32_t"
},
{
"name": "right",
"desc": "拖动范围的右边限制。缺省为父控件的右边边。",
"type": "int32_t"
},
{
"name": "vertical_only",
"desc": "只允许垂直拖动。",
"type": "bool_t"
},
{
"name": "horizontal_only",
"desc": "只允许水平拖动。",
"type": "bool_t"
},
{
"name": "drag_window",
"desc": "拖动窗口而不是父控件。比如放在对话框的titlebar上拖动titlebar其实是希望拖动对话框。",
"type": "bool_t"
}
]
},
{
"name": "color_picker",
"parent": "widget",
"desc": "颜色选择器。",
"props": [
{
"name": "value",
"desc": "颜色。",
"type": "const char*"
}
]
},
{
"name": "color_component",
"parent": "widget",
"desc": "颜色选择器的颜色分量。",
"props": []
},
{
"name": "canvas_widget",
"parent": "widget",
"desc": "画布控件。",
"props": []
},
{
"name": "image_base",
"parent": "widget",
"desc": "图片控件基类。",
"props": [
{
"name": "image",
"desc": "图片的名称。",
"type": "char*"
},
{
"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在控件底部。",
"type": "float_t"
},
{
"name": "scale_x",
"desc": "控件在X方向上的缩放比例。",
"type": "float_t"
},
{
"name": "scale_y",
"desc": "控件在Y方向上的缩放比例。",
"type": "float_t"
},
{
"name": "rotation",
"desc": "控件的旋转角度(幅度)。",
"type": "float_t"
},
{
"name": "clickable",
"desc": "点击时是否触发EVT_CLICK事件。",
"type": "bool_t"
},
{
"name": "selectable",
"desc": "是否设置选中状态。",
"type": "bool_t"
}
]
},
{
"name": "window_base",
"parent": "widget",
"desc": "窗口。",
"props": [
{
"name": "theme",
2021-05-11 15:50:24 +08:00
"desc": "窗体样式资源的名称。\n每个窗口都可以有独立的窗体样式文件如果没指定则使用系统缺省的窗体样式文件。\n窗体样式是一个XML文件放在assets/raw/styles目录下。\n请参考[窗体样式](https://github.com/zlgopen/awtk/blob/master/docs/theme.md)",
2020-10-07 09:42:38 +08:00
"type": "char*"
},
{
"name": "disable_anim",
"desc": "禁用窗口动画。",
"type": "bool_t"
},
{
"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"
},
{
"name": "open_anim_hint",
"desc": "打开窗口动画的名称。\n请参考[窗口动画](https://github.com/zlgopen/awtk/blob/master/docs/window_animator.md)",
"type": "char*"
},
{
"name": "close_anim_hint",
"desc": "关闭窗口动画的名称。\n请参考[窗口动画](https://github.com/zlgopen/awtk/blob/master/docs/window_animator.md)",
"type": "char*"
},
{
"name": "move_focus_prev_key",
"desc": "向前移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)",
"type": "char*"
},
{
"name": "move_focus_next_key",
"desc": "向后移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)",
"type": "char*"
},
{
"name": "move_focus_up_key",
"desc": "向上移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)",
"type": "char*"
},
{
"name": "move_focus_down_key",
"desc": "向下移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)",
"type": "char*"
},
{
"name": "move_focus_left_key",
"desc": "向左移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)",
"type": "char*"
},
{
"name": "move_focus_right_key",
"desc": "向右移动焦点的键值。\n\n请参考[控件焦点](https://github.com/zlgopen/awtk/blob/master/docs/widget_focus.md)",
"type": "char*"
}
]
},
{
"name": "calibration_win",
"parent": "window_base",
"desc": "电阻屏校准窗口。",
"props": []
},
{
"name": "gif_image",
"parent": "image_base",
"desc": "GIF图片控件。",
"props": []
},
{
"name": "keyboard",
"parent": "window_base",
"desc": "软键盘。",
"props": []
},
{
"name": "mutable_image",
"parent": "image_base",
"desc": "mutable图片控件。",
"props": []
},
{
"name": "window",
"parent": "window_base",
"desc": "窗口。",
"props": [
{
"name": "fullscreen",
"desc": "是否全屏。\n\n>这里全屏是指与LCD相同大小而非让SDL窗口全屏。",
"type": "bool_t"
}
]
},
{
"name": "svg_image",
"parent": "image_base",
"desc": "SVG图片控件。",
"props": []
},
{
"name": "combo_box",
"parent": "edit",
"desc": "下拉列表控件。",
"props": [
{
"name": "open_window",
"desc": "为点击按钮时,要打开窗口的名称。",
"type": "char*"
},
{
"name": "selected_index",
"desc": "当前选中的选项。",
"type": "int32_t"
},
{
"name": "value",
"desc": "值。",
"type": "int32_t"
},
{
"name": "localize_options",
"desc": "是否本地化(翻译)选项(缺省为TRUE)。",
"type": "bool_t"
},
{
"name": "options",
"desc": "设置可选项(冒号分隔值和文本,分号分隔选项,如:1:red;2:green;3:blue)。",
"type": "char*"
},
{
"name": "item_height",
"desc": "下拉选项的高度。如果open_window为空则使用缺省高度。",
"type": "int32_t"
}
]
},
{
"name": "image",
"parent": "image_base",
"desc": "图片控件。",
"props": [
{
"name": "draw_type",
"desc": "图片的绘制方式(仅在没有旋转和缩放时生效)。",
"type": "image_draw_type_t"
}
]
},
{
"name": "overlay",
"parent": "window_base",
"desc": "overlay窗口。",
"props": [
{
"name": "click_through",
"desc": "点击穿透。点击没有子控件的位置,是否穿透到底层窗口。\n\n缺省不启用。",
"type": "bool_t"
}
]
},
{
"name": "popup",
"parent": "window_base",
"desc": "弹出窗口。",
"props": [
{
"name": "close_when_click",
"desc": "点击时是否关闭窗口。",
"type": "bool_t"
},
{
"name": "close_when_click_outside",
"desc": "点击到窗口外时是否关闭窗口。",
"type": "bool_t"
}
]
},
{
"name": "spin_box",
"parent": "edit",
"desc": "spinbox控件。",
"props": []
},
{
"name": "system_bar",
"parent": "window_base",
"desc": "system\\_bar窗口。",
"props": []
},
{
"name": "dialog",
"parent": "window_base",
"desc": "对话框。 对话框是一种特殊的窗口,大小和位置可以自由设置。",
"props": [
{
"name": "highlight",
"desc": "对话框高亮策略。\n\n> 请参考 [对话框高亮策略](https://github.com/zlgopen/awtk/blob/master/docs/dialog_highlight.md)",
"type": "const char*"
}
]
},
{
"name": "combo_box_ex",
"parent": "combo_box",
"desc": "可滚动的combo_box控件。",
"props": []
}
]
}