guix事件定义记录(翻译官方)

前言

1. 官方资料

事件描述

/*
GX_EVENT_TERMINATE
- Description:
    应用程序可以发送此事件，以有意终止 GUIX 执行线程。
    此事件还会导致模式执行窗口终止模式执行并返回GX_EVENT_TERMINATE。
    当桌面窗口关闭时，GUIX Win32 绑定在内部使用此事件终止 GUIX 应用程序。
- Payload: None

GX_EVENT_REDRAW
- Description:
    可以生成此事件以强制 GUIX 重绘每个根窗口（以及所有子窗口/小部件）。
    此事件将每个根窗口标记为脏窗口，并在下一次画布刷新操作发生时强制重新绘制完整的系统。
    此事件还用于桌面操作，以便在桌面操作系统请求重新绘制时强制刷新 GUIX 画布。
- Payload: None

GX_EVENT_SHOW
- Description:
    每当小部件可见时，都会在内部生成此事件，方法是通过附加到可见小部件或调用 gx_widget_show（） API。
    在绘制小组件之前接收事件。
- Payload: None

GX_EVENT_HIDE
- Description:
    每当通过与小部件分离或通过调用 gx_widget_hide（） API 隐藏小部件时，都会在内部生成此事件。
    在将小组件设为隐藏状态之前，将接收到该事件。
- Payload: None.

GX_EVENT_RESIZED
- Description:
    通过 gx_widget_resize API 调整小组件大小时，将生成此事件。
    仅当小组件gx_widget_status成员包含GX_STATUS_RESIZE_NOTIFY时，才会生成该事件。
- Payload: None.

GX_EVENT_SLIDE
- Description: 保留以备将来使用。
- Payload: None.

GX_EVENT_FOCUS_GAINED
- Description: 当小组件接收到输入焦点时，此事件在内部生成。
- Payload: None.

GX_EVENT_FOCUS_LOST
- Description: 当小组件失去输入焦点时，内部会生成此事件。
- Payload: None.

GX_EVENT_HORIZONTAL_SCROLL
- Description: 此事件由水平滚动条生成，用于通知父窗口滚动操作。该事件也可以由应用程序生成，以强制窗口滚动其子小部件。
- Payload: gx_event_intdata[0] 包含当前滚动条值。
           gx_event_intdata[1] 包含上一个滚动条值。

GX_EVENT_VERTICAL_SCROLL
- Description: 此事件由垂直滚动条生成，用于通知父窗口滚动操作。该事件也可以由应用程序生成，以强制窗口滚动其子小部件。
- Payload: gx_event_intdata[0] 包含当前滚动条值.
           gx_event_intdata[1] 包含上一个滚动条值。

GX_EVENT_TIMER
- Description: 此事件将发送给计时器所有者，以通知计时器过期的所有者。
- Payload: gx_event_timer_id 包含用户分配的计时器 ID。
           sgx_event_target 包含指向计时器所有者的指针。

GX_EVENT_PEN_DOWN
- Description: 此事件由触摸屏和鼠标输入驱动程序生成，以指示用户按下笔（或鼠标左键单击）事件。
- Payload: gx_event_pointdata.gx_point_x = pen x position in pixels
           gx_event_pointdata.gx_point_y = pen y position in pixels
           gx_event_display_handle = handle of the target display

GX_EVENT_PEN_UP
- Description: 此事件由触摸屏和鼠标输入驱动程序生成，以指示用户笔下（或鼠标左键释放）事件。
- Payload: gx_event_pointdata.gx_point_x = pen x position in pixels
           gx_event_pointdata.gx_point_y = pen y position in pixels
           gx_event_display_handle = handle of the target display

GX_EVENT_PEN_MOVE
- Description: 此事件由鼠标输入驱动程序生成，以指示鼠标已移动到新位置，但未按下任何按钮。
- Payload: gx_event_pointdata.gx_point_x = pen x position in pixels
           gx_event_pointdata.gx_point_y = pen y position in pixels
           gx_event_display_handle = handle of the target display

GX_EVENT_PEN_DRAG
- Description: 此事件由鼠标和触摸输入驱动程序生成，以指示笔正在屏幕上拖动，或者在按下鼠标左键时正在移动鼠标。
- Payload: gx_event_pointdata.gx_point_x = pen x position in pixels
           gx_event_pointdata.gx_point_y = pen y position in pixels
           gx_event_display_handle =目标显示器的handle

GX_EVENT_KEY_DOWN:
- Description: 此事件由键盘输入驱动程序生成，以指示已按下键盘键.
- Payload: gx_event_ushortdata[0] 保存 Unicode 键值。

GX_EVENT_KEY_UP
- Description: 此事件由键盘输入驱动程序生成，以指示已释放键盘键。
- Payload: gx_event_ushortdata[0] 保存 Unicode 键值。

GX_EVENT_CLOSE
- Description:
    此事件可以发送到任何GX_WINDOW派生的小部件，以使该窗口与其父窗口分离（即隐藏）。
    如果窗口是以模式方式执行的，它将退出模式执行循环并返回GX_EVENT_CLOSE。
- Payload: None.

GX_EVENT_DELETE
- Description:
    使用 _gx_widget_delete API 时，此事件将发送到任何小组件。
    此事件通知小组件即将被删除，从而允许小组件执行必要的清理或内存释放
- Payload: gx_event_target 指向正在删除的小组件.

GX_EVENT_SLIDER_VALUE
- Description: 这是由基于GX_SLIDER的子控件生成的GX_SIGNAL事件类型。它通知滑块父级滑块已被用户操作。
- Payload: gx_event_longdata 保存新的滑块值.
           gx_event_sender 保存滑块小组件的 ID。

GX_EVENT_TOGGLE_ON
- Description: 这是由复选框样式（即切换样式）GX_BUTTON小部件生成的GX_SIGNAL事件类型。它通知按钮父项复选框已更改为选中状态。
- Payload: gx_event_sender 保存按钮小部件的 ID。

GX_EVENT_TOGGLE_OFF
- Description: 这是由复选框样式（即切换样式）GX_BUTTON小部件生成的GX_SIGNAL事件类型。它通知按钮父级复选框已更改为未选中状态。
- Payload: gx_event_sender 保存按钮小部件的 ID。

GX_EVENT_RADIO_SELECT
- Description: 这是由单选按钮样式（即独占样式）GX_BUTTON小部件生成的GX_SIGNAL事件类型。它通知按钮父级单选按钮已更改为打开状态。
- Payload: gx_event_sender 保存按钮小部件的 ID。

GX_EVENT_RADIO_DESELECT
- Description:这是由单选按钮样式（即独占样式）GX_BUTTON小部件生成的GX_SIGNAL事件类型。它通知按钮父级单选按钮已更改为关闭状态。
- Payload: gx_event_sender 保存按钮小部件的 ID。

GX_EVENT_CLICKED
- Description: 这是由所有已启用的小组件类型生成的GX_SIGNAL事件类型。此事件通知小组件父级用户已单击子小组件。
- Payload: gx_event_sender 保存小组件的 ID。

GX_EVENT_LIST_SELECT
- Description:这是由所有水平列表、垂直列表、滚轮和下拉列表样式的子小部件生成的GX_SIGNAL事件类型。此事件通知小组件父级用户已选择新的列表条目。
- Payload: gx_event_sender 保存小部件的 ID.
           gx_event_longdata 保存新的列表选择索引。

GX_EVENT_VERTICAL_FLICK
- Description: 当笔在垂直方向上移动时被拖动和释放时，会在内部生成此事件。gx_scroll_wheel 和 gx_vertical_list 小部件捕获此事件以实现列表的动画切换。
- Payload: gx_event_intdata[0] 保持笔速。

GX_EVENT_HORIZONTAL_FLICK
- Description: 当笔在水平方向上移动时被拖动和释放时，会在内部生成此事件。gx_horizontal_list widget 捕获此事件以实现动画轻拂列表。
- Payload: gx_event_intdata[0] 保持笔速.

GX_EVENT_PARENT_SIZED
- Description:
    当使用 gx_widget_resize（） 调整任何GX_WINDOW派生的 Widget 类型的大小时，将在内部生成此事件。
    这允许子小部件（如滚动条）根据需要调整自身大小以适应新的父窗口尺寸。
- Payload: None

GX_EVENT_CLOSE_POPUP
- Description: 此事件在内部用于关闭下拉列表小部件拥有的弹出列表
- Payload: None

GX_EVENT_ZOOM_IN
- Description: 此事件由多点触控触摸输入驱动程序生成，以指示用户已输入放大手势。
- Payload: None

GX_EVENT_ZOOM_OUT
- Description: 此事件由多点触控触摸输入驱动程序生成，以指示用户已输入缩小手势。]
- Payload: None

GX_EVENT_LANGUAGE_CHANGE
- Description:
    当通过调用 gx_display_active_langauge_set（） 更改活动语言时，将生成此事件并将其传递到所有可见小部件。
    这允许基于文本的小部件检索与活动语言关联的新字符串。
- Payload: None

GX_EVENT_RESOURCE_CHANGE
- Description: 当活动主题发生更改时，将生成此事件并将其传递到所有可见小组件。这允许使用像素图和字体资源的小部件将自己标记为脏污并使用新主题重新绘制。
- Payload: None

GX_EVENT_ANIMATION_COMPLETE
- Description: 当gx_animation_manager正在执行的动画完成时，将生成此事件
- Payload: gx_event_target 设置为animation_parent
           gx_event_sender 保存动画 ID

GX_EVENT_SPRITE_COMPLETE
- Description: 此GX_SIGNAL事件由gx_sprite widget 在 sprite 动画序列完成时生成。
- Payload: gx_event_sender 保存 Sprite Widget ID

GX_EVENT_TEXT_EDITED
- Description: 当用户编辑文本字符串时，此GX_SIGNAL事件由单行和多行文本输入小组件生成。
- Payload: gx_event_sender 保存文本输入小组件 ID

GX_EVENT_FOCUS_NEXT
- Description:
    此事件可以由应用程序生成，也可以由输入驱动程序生成，以将小组件输入焦点移动到小组件焦点列表中的下一个小组件。
    制作gx_window类型小部件时可见的，它会自动创建接受输入焦点的子小部件的链表。此事件可用于将焦点从一个子小组件移动到下一个子小组件。
- Payload: None.

GX_EVENT_FOCUS_PREVIOUS
- Description:
    此事件可以由应用程序生成，也可以由输入驱动程序生成，以将小组件输入焦点移动到小组件焦点列表中的上一个小组件。
    当gx_window类型微件可见时，它会自动创建接受输入焦点的子微件的链表。此事件可用于将焦点从一个子小组件移动到上一个小组件。
- Payload: None.

GX_EVENT_FOCUS_GAIN_NOTIFY
- Description:
    此GX_SIGNAL样式事件可由子小组件在获得输入焦点时生成。
    为了使子小组件生成此信号，子小组件必须具有非零 ID，并且必须设置GX_STATUS_NOTIFY_ON_GAIN_FOCUS状态标志。
- Payload: gx_event_sender 保存子小组件 ID。

GX_EVENT_SELECT
- Description: 此事件可以由应用程序生成，以将按钮置于选中或已推下状态。
- Payload: None.

GX_EVENT_DESELECT
- Description: 此事件可由应用程序生成，以将按钮置于非选择或未按下状态。
- Payload: None.

GX_EVENT_PROGRESS_VALUE
- Description: 这是更改进度条值时由 progress_bar 类型小组件生成的GX_SIGNAL类型事件。
- Payload: gx_event_longdata 保存新的进度条值。

GX_EVENT_TOUCH_CALIBRATION_COMPLETE
- Description: 当触摸屏校准序列完成时，此事件由通用电阻式触摸屏输入驱动程序发送。这会通知应用程序，在执行校准序列后，正常的屏幕显示可以开始或恢复。
- Payload: None.

GX_EVENT_INPUT_RELEASE
- Description:
    此事件是一个命令，告诉任何已捕获用户输入（触摸、键盘）的小部件释放它。
    此命令事件由屏幕拖动动画事件处理程序用于强制子小组件释放输入捕获，但也可以由应用程序生成。
- Payload: None.

GX_EVENT_TREE_SELECT
- Description: 当用户选择树节点时，此事件由gx_tree_view小部件生成。
- Payload: gx_event_sender 包含树构件 ID。
           gx_event_longdata 保存所选树节点的 ID。

GX_EVENT_STYLE_CHANGED
- Description:
    当使用 gx_widget_style_add（） 或 gx_widget_style_remove（） API 更改小部件样式时，
    将生成此事件。这允许目标小部件在样式更改需要时重新绘制。
- Payload: gx_event_ulongdata 保存以前的小部件样式标志.
           gx_event_target 指向修改后的小部件。

GX_EVENT_CLIENT_UPDATED
- Description: 当通过添加或删除非客户端子项（例如添加或删除滚动条）来修改窗口的工作区时，将生成此事件。
- Payload: None.

GX_EVENT_CUT
- Description: 此事件由输入设备驱动程序生成，用于命令文本输入小组件将所选文本剪切到 GUIX 剪贴板。
- Payload: None.

GX_EVENT_COPY
- Description: 此事件由输入设备驱动程序生成，用于命令文本输入小组件将所选文本复制到 GUIX 剪贴板。
- Payload: None.

GX_EVENT_PASTE
- Description: 此事件由输入设备驱动程序生成，用于命令文本输入小组件将所选文本粘贴到 GUIX 剪贴板。
- Payload: None.

GX_EVENT_MARK_NEXT
- Description: 此事件由输入设备驱动程序生成，用于命令文本输入小组件标记输入字符串中的下一个字符。
- Payload: None.

GX_EVENT_MARK_PREVIOUS
- Description: 此事件由输入设备驱动程序生成，用于命令文本输入小组件标记输入字符串中的上一个字符。
- Payload: None.

GX_EVENT_MARK_UP
- Description: 此事件由输入设备驱动程序生成，用于命令文本输入小组件标记输入字符串中的上一行字符。
- Payload: None.

GX_EVENT_MARK_DOWN
- Description: 此事件由输入设备驱动程序生成，用于命令文本输入小组件在输入字符串中标记以下字符行。
- Payload: None.

GX_EVENT_MARK_END
- Description: 此事件由输入设备驱动程序生成，用于命令文本输入小组件将结束标记移动到输入字符串的末尾。
- Payload: None.

GX_EVENT_MARK_HOME
- Description: 此事件由输入设备驱动程序生成，用于命令文本输入小组件将开始标记移动到输入字符串的开头。
- Payload: None.

 */