8B. 枚举速查表

汇总 GT-HMI Engine 中所有全局枚举类型及其可选值。各控件的 API 参数说明中引用此表。

---

对齐方式 gt_align_et

枚举值	说明
GT_ALIGN_NONE	无对齐
GT_ALIGN_LEFT	左上
GT_ALIGN_LEFT_MID	左中
GT_ALIGN_LEFT_BOTTOM	左下
GT_ALIGN_RIGHT	右上
GT_ALIGN_RIGHT_MID	右中
GT_ALIGN_RIGHT_BOTTOM	右下
GT_ALIGN_CENTER	中上
GT_ALIGN_CENTER_MID	居中
GT_ALIGN_CENTER_BOTTOM	中下

长文本模式 gt_text_long_mode_et

枚举值	说明
GT_TEXT_LONG_MODE_WRAP	换行
GT_TEXT_LONG_MODE_DOT	省略号
GT_TEXT_LONG_MODE_SCROLL	滚动

条形图/滑动条方向 gt_bar_dir_et

枚举值	说明
GT_BAR_DIR_HOR_L2R	水平从左到右
GT_BAR_DIR_HOR_R2L	水平从右到左
GT_BAR_DIR_VER_U2D	垂直从上到下
GT_BAR_DIR_VER_D2U	垂直从下到上

滚动方向 gt_scroll_dir_et

枚举值	说明
GT_SCROLL_DISABLE	禁止滚动
GT_SCROLL_HORIZONTAL	仅水平滚动
GT_SCROLL_VERTICAL	仅垂直滚动
GT_SCROLL_ALL	允许所有方向滚动（默认）

滚动对齐 gt_scroll_snap_em

枚举值	说明
GT_SCROLL_SNAP_NONE	无对齐
GT_SCROLL_SNAP_START	子对象前沿对齐父对象前沿
GT_SCROLL_SNAP_END	子对象后沿对齐父对象后沿
GT_SCROLL_SNAP_CENTER	子对象中心对齐父对象中心

滚动提示条 gt_scroll_tip_et

枚举值	说明
GT_SCROLL_TIP_NONE	无提示条（默认）
GT_SCROLL_TIP_LEFT	左侧提示条
GT_SCROLL_TIP_RIGHT	右侧提示条
GT_SCROLL_TIP_TOP	顶部提示条
GT_SCROLL_TIP_BOTTOM	底部提示条

可通过 | 组合多个位置，如 GT_SCROLL_TIP_LEFT | GT_SCROLL_TIP_RIGHT

可见性 gt_visible_et

枚举值	说明
GT_VISIBLE	可见（默认）
GT_INVISIBLE	不可见

禁用状态 gt_disabled_et

枚举值	说明
GT_ENABLED	启用（默认）
GT_DISABLED	禁用

对象状态 gt_state_et

枚举值	说明
GT_STATE_NONE	正常（默认）
GT_STATE_PRESSED	按下

状态触发模式 gt_obj_trigger_mode_et

枚举值	说明
GT_OBJ_TRIGGER_MODE_HOLD_ON	按住时保持（默认）
GT_OBJ_TRIGGER_MODE_SWITCH	点击切换

布局类型 gt_layout_type_e

枚举值	说明
GT_LAYOUT_TYPE_FIXED	绝对定位（默认）
GT_LAYOUT_TYPE_FLEX	Flex 弹性布局

Flex 主轴方向 gt_layout_flex_direction_e

枚举值	说明
GT_LAYOUT_FLEX_DIR_ROW	水平排列（默认）
GT_LAYOUT_FLEX_DIR_ROW_REVERSE	水平反向排列
GT_LAYOUT_FLEX_DIR_COLUMN	垂直排列
GT_LAYOUT_FLEX_DIR_COLUMN_REVERSE	垂直反向排列

Flex 主轴对齐 gt_layout_justify_content_e

枚举值	说明
GT_LAYOUT_JUSTIFY_CONTENT_START	起始对齐
GT_LAYOUT_JUSTIFY_CONTENT_END	末尾对齐
GT_LAYOUT_JUSTIFY_CONTENT_CENTER	居中
GT_LAYOUT_JUSTIFY_CONTENT_SPACE_BETWEEN	两端对齐（间距=item数-1）
GT_LAYOUT_JUSTIFY_CONTENT_SPACE_AROUND	环绕分布（间距=item数）
GT_LAYOUT_JUSTIFY_CONTENT_SPACE_EVENLY	均匀分布（间距=item数+1）

Flex 交叉轴对齐 gt_layout_align_items_e

枚举值	说明
GT_LAYOUT_ALIGN_ITEMS_START	顶部/左侧对齐
GT_LAYOUT_ALIGN_ITEMS_END	底部/右侧对齐
GT_LAYOUT_ALIGN_ITEMS_CENTER	居中对齐

Flex 收缩 gt_layout_shrink_e

枚举值	说明
GT_LAYOUT_SHRINK_DISABLE	不收缩（默认）
GT_LAYOUT_SHRINK_ENABLE	允许收缩以适配父容器

字体风格 gt_font_style_et

可通过 | 组合，如 GT_FONT_STYLE_BOLD | GT_FONT_STYLE_ITALIC

枚举值	说明
GT_FONT_STYLE_NORMAL	正常
GT_FONT_STYLE_BOLD	粗体
GT_FONT_STYLE_ITALIC	斜体
GT_FONT_STYLE_UNDERLINE	下划线
GT_FONT_STYLE_STRIKETHROUGH	删除线

字体灰度 gt_font_gray_et

枚举值	说明
GT_FONT_GRAY_1	1-bit 灰度
GT_FONT_GRAY_2	2-bit 灰度
GT_FONT_GRAY_4	4-bit 灰度

字符编码 gt_encoding_et

枚举值	说明
GT_ENCODING_UTF8	UTF-8（默认）
GT_ENCODING_GB2312	GB2312
GT_ENCODING_GBK	GBK
GT_ENCODING_BIG5	BIG5
GT_ENCODING_SHIFT_JIS	Shift-JIS
GT_ENCODING_EUC_KR	EUC-KR

图表类型 gt_graphs_type_et

枚举值	说明
GT_GRAPHS_TYPE_POINT	散点图
GT_GRAPHS_TYPE_LINE	折线图
GT_GRAPHS_TYPE_CURVE	曲线图
GT_GRAPHS_TYPE_BAR	柱状图

画笔端点 gt_brush_type_et

枚举值	说明
GT_BRUSH_TYPE_ROUND	圆形端点（默认）
GT_BRUSH_TYPE_RECT	方形端点

屏幕切换动画 gt_scr_anim_type_et

枚举值	说明
GT_SCR_ANIM_TYPE_NONE	无动画
GT_SCR_ANIM_TYPE_MOVE_LEFT	向左平移
GT_SCR_ANIM_TYPE_MOVE_RIGHT	向右平移
GT_SCR_ANIM_TYPE_MOVE_UP	向上平移
GT_SCR_ANIM_TYPE_MOVE_DOWN	向下平移
GT_SCR_ANIM_TYPE_COVER_LEFT	从左侧覆盖
GT_SCR_ANIM_TYPE_COVER_RIGHT	从右侧覆盖
GT_SCR_ANIM_TYPE_COVER_UP	从上方覆盖
GT_SCR_ANIM_TYPE_COVER_DOWN	从下方覆盖
GT_SCR_ANIM_TYPE_UNCOVER_LEFT	旧屏左滑离开
GT_SCR_ANIM_TYPE_UNCOVER_RIGHT	旧屏右滑离开
GT_SCR_ANIM_TYPE_UNCOVER_UP	旧屏上滑离开
GT_SCR_ANIM_TYPE_UNCOVER_DOWN	旧屏下滑离开

频谱类型 gt_spectrum_type_et

枚举值	说明
GT_SPECTRUM_TYPE_CIRCLE	圆形频谱
GT_SPECTRUM_TYPE_RECT	矩形条
GT_SPECTRUM_TYPE_RECT_UD	矩形条上下镜像
GT_SPECTRUM_TYPE_STAIR	阶梯形

频谱颜色类型 gt_spectrum_color_type_et

枚举值	说明
GT_SPECTRUM_COLOR_TYPE_RANGE	按频谱范围渐变
GT_SPECTRUM_COLOR_TYPE_NUMB	按频谱条数渐变

日历日期类型 gt_calendar_day_type_et

枚举值	说明
GT_CALENDAR_DAY_TYPE_NORMAL	普通日期
GT_CALENDAR_DAY_TYPE_HOLIDAY	节假日
GT_CALENDAR_DAY_TYPE_WORKDAY	工作日

Toast 位置 gt_toast_pos_st

枚举值	说明
GT_TOAST_POS_MIDDLE	屏幕居中（默认）
GT_TOAST_POS_TOP	屏幕顶部
GT_TOAST_POS_BOTTOM	屏幕底部

十字布局滚动模式 gt_cross_roll_mode_et

枚举值	说明
GT_CROSS_ROLL_DEFAULT	标准滚动（默认）
GT_CROSS_ROLL_LOOP	无限循环滚动
GT_CROSS_ROLL_MOVE	拖拽滚动

十字布局触摸模式 gt_cross_touch_mode_et

枚举值	说明
GT_CROSS_TOUCH_MODE_INDEPENDENT	水平/垂直触摸独立处理（默认）
GT_CROSS_TOUCH_MODE_MERGE	水平/垂直触摸合并处理

动态帧率 gt_obj_frame_rate_et

条件编译宏：GT_USE_WIDGET_DYNAMIC_FRAME_RATE

枚举值	说明
GT_OBJ_FRAME_RATE_HIGH	═ GT_OBJ_FRAME_RATE_DEFAULT
GT_OBJ_FRAME_RATE_MIDDLE	中等帧率
GT_OBJ_FRAME_RATE_LOW	低帧率

颜色透明度常量 gt_opa_et

定义于 gt_color.h

常量	值	说明
GT_OPA_0	0	全透明
GT_OPA_10	25	10%
GT_OPA_20	51	20%
GT_OPA_30	76	30%
GT_OPA_40	102	40%
GT_OPA_50	127	50%
GT_OPA_60	153	60%
GT_OPA_70	178	70%
GT_OPA_80	204	80%
GT_OPA_90	229	90%
GT_OPA_COVER	255	完全不透明

控件类型 gt_obj_type_et

完整控件类型枚举，用于 gt_obj_search_child_by_type() 等 API。

ID	枚举值	控件
-3	GT_TYPE_UNKNOWN	未知
-2	GT_TYPE_LAYER_TOP	浮层
-1	GT_TYPE_SCREEN	屏幕
0	GT_TYPE_OBJ	基类
1	GT_TYPE_BTN	按钮
2	GT_TYPE_IMG	图片
3	GT_TYPE_LAB	标签
4	GT_TYPE_TEXTAREA	文本区
5	GT_TYPE_CANVAS	画布
6	GT_TYPE_OPTION	选项
7	GT_TYPE_GROUP	分组
8	GT_TYPE_CHECKBOX	复选框
9	GT_TYPE_RADIO	单选框
10	GT_TYPE_INPUT	输入框
11	GT_TYPE_SWITCH	开关
12	GT_TYPE_SLIDER	滑动条
13	GT_TYPE_PROCESS_BAR	进度条
14	GT_TYPE_KEYPAD	键盘
15	GT_TYPE_IMGBTN	图片按钮
16	GT_TYPE_BARCODE	一维码
17	GT_TYPE_QRCODE	二维码
18	GT_TYPE_LINE	直线
19	GT_TYPE_PLAYER	幻灯片
20	GT_TYPE_INPUT_NUMBER	计数器
21	GT_TYPE_CLOCK	时钟
22	GT_TYPE_WORDART	艺术字
23	GT_TYPE_VIEW_PAGER	滑窗
24	GT_TYPE_GIF	GIF
25	GT_TYPE_RECT	矩形
26	GT_TYPE_LISTVIEW	列表
27	GT_TYPE_TEMPLATE	模板
28	GT_TYPE_ROLLER	滚轮
29	GT_TYPE_BTNMAP	按钮矩阵
30	GT_TYPE_DIALOG	弹窗
31	GT_TYPE_CHAT	聊天框
32	GT_TYPE_STATUS_BAR	状态栏
33	GT_TYPE_GRAPH	线图
34	GT_TYPE_MEDIA_PLAYER	媒体播放器
35	GT_TYPE_BIT_IMG	位图
36	GT_TYPE_ARC	圆弧
37	GT_TYPE_SELECT	下拉框
38	GT_TYPE_TABLE	表格
39	GT_TYPE_MARKDOWN	Markdown
40	GT_TYPE_CROSS_LAYOUT	十字布局
41	GT_TYPE_CALENDAR	日历
42	GT_TYPE_SPECTRUM	频谱
43	GT_TYPE_SPECTRUM_LINE	频谱线
44	GT_TYPE_TOAST	提示弹窗
45	GT_TYPE_INDEV_EFFECTS	输入效果
46	GT_TYPE_LRC	歌词
47	GT_TYPE_QR_EXT	二维码扩展
48	GT_TYPE_FORMULA	公式