QEvent Class
QEvent 类是所有事件类的基类。事件对象包含事件参数。更多
| 头文件： | #include <QEvent> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake： | QT += core |
| 被继承： | 32 类型QActionEvent,QChildEvent,QChildWindowEvent,QCloseEvent,QDragLeaveEvent,QDropEvent,QDynamicPropertyChangeEvent,QExposeEvent,QFileOpenEvent,QFocusEvent,QGestureEvent,QGraphicsSceneEvent,QHelpEvent,QHideEvent,QIconDragEvent,QInputEvent,QInputMethodEvent,QInputMethodQueryEvent,QMoveEvent,QPaintEvent,QPlatformSurfaceEvent,QResizeEvent,QScrollEvent,QScrollPrepareEvent,QShortcutEvent,QShowEvent,QStateMachine::SignalEvent,QStateMachine::WrappedEvent,QStatusTipEvent,QTimerEvent,QWhatsThisClickedEvent, 以及QWindowStateChangeEvent |
- 所有成员的列表，包括继承成员
- QEvent 属于事件类。
公共类型
| enum | Type { None, ActionAdded, ActionChanged, ActionRemoved, ActivationChange, …, MaxUser } |
属性
- accepted : bool
公共函数
| QEvent(QEvent::Type type) | |
| virtual | ~QEvent() |
| void | accept() |
(since 6.0) virtual QEvent * | clone() const |
| void | ignore() |
| bool | isAccepted() const |
(since 6.0) bool | isInputEvent() const |
(since 6.0) bool | isPointerEvent() const |
(since 6.0) bool | isSinglePointEvent() const |
| virtual void | setAccepted(bool accepted) |
| bool | spontaneous() const |
| QEvent::Type | type() const |
静态公共成员
| int | registerEventType(int hint = -1) |
详细说明
Qt 的主事件循环 (QCoreApplication::exec()) 从事件队列中获取本地窗口系统事件，将其转换为 QEvents，并将转换后的事件发送至QObjects。
一般来说，事件来自底层窗口系统（spontaneous() 返回true ），但也可以使用QCoreApplication::sendEvent() 和QCoreApplication::postEvent() 手动发送事件（spontaneous() 返回false ）。
QObjects 通过调用 () 函数来接收事件。该函数可在子类中重新实现，以自定义事件处理并添加其他事件类型； () 就是一个显著的例子。默认情况下，事件会被派发到 () 和 () 等事件处理程序。() 允许一个对象拦截指向另一个对象的事件。QObject::event QWidget::event QObject::timerEvent QWidget::mouseMoveEvent QObject::installEventFilter
基本的 QEvent 只包含一个事件类型参数和一个 "接受 "标志。接受标志通过accept() 设置，并通过ignore() 清除。它默认设置，但不要依赖它，因为子类可能会选择在构造函数中清除它。
QEvent 的子类包含描述特定事件的附加参数。
另请参阅 QObject::event(),QObject::installEventFilter(),QCoreApplication::sendEvent(),QCoreApplication::postEvent() 和QCoreApplication::processEvents().
成员类型文档
enum QEvent::Type
该枚举类型定义了 Qt 中有效的事件类型。事件类型和每种类型的专用类如下：
| 常量 | 值 | 说明 |
|---|---|---|
QEvent::None | 0 | 不是事件。 |
QEvent::ActionAdded | 114 | 已添加新操作 (QActionEvent)。 |
QEvent::ActionChanged | 113 | 更改了一个操作 (QActionEvent)。 |
QEvent::ActionRemoved | 115 | 删除了一个操作 (QActionEvent)。 |
QEvent::ActivationChange | 99 | 部件的顶层窗口激活状态已更改。 |
QEvent::ApplicationActivate | 121 | 该枚举已被弃用。请使用 ApplicationStateChange 代替。 |
QEvent::ApplicationActivated | ApplicationActivate | 该枚举已被弃用。请使用 ApplicationStateChange 代替。 |
QEvent::ApplicationDeactivate | 122 | 此枚举已被弃用。请使用 ApplicationStateChange 代替。 |
QEvent::ApplicationFontChange | 36 | 默认应用程序字体已更改。 |
QEvent::ApplicationLayoutDirectionChange | 37 | 默认应用程序布局方向已更改。 |
QEvent::ApplicationPaletteChange | 38 | 默认应用程序调色板已更改。 |
QEvent::ApplicationStateChange | 214 | 应用程序的状态已更改。 |
QEvent::ApplicationWindowIconChange | 35 | 应用程序的图标已更改。 |
QEvent::ChildAdded | 68 | 对象有了子对象 (QChildEvent)。 |
QEvent::ChildPolished | 69 | 窗口小部件的子窗口被打磨 (QChildEvent)。 |
QEvent::ChildRemoved | 71 | 一个对象失去了一个子对象 (QChildEvent)。 |
QEvent::ChildWindowAdded (since Qt 6.7) | 223 | 窗口中添加了一个子窗口。 |
QEvent::ChildWindowRemoved (since Qt 6.7) | 224 | 从窗口中删除了一个子窗口。 |
QEvent::Clipboard | 40 | 剪贴板内容已更改。 |
QEvent::Close | 19 | 小工具被关闭 (QCloseEvent)。 |
QEvent::CloseSoftwareInputPanel | 200 | Widget 想要关闭软件输入面板 (SIP)。 |
QEvent::ContentsRectChange | 178 | 窗口小部件内容的边距已更改。 |
QEvent::ContextMenu | 82 | 上下文弹出菜单 (QContextMenuEvent)。 |
QEvent::CursorChange | 183 | widget 的光标已更改。 |
QEvent::DeferredDelete | 52 | 对象将在清理后被删除（QDeferredDeleteEvent）。 |
QEvent::DevicePixelRatioChange (since Qt 6.6) | 222 | 该 widget 或窗口的底层后备存储的 devicePixelRatio 已更改。 |
QEvent::DragEnter | 60 | 光标在拖放操作过程中进入部件 (QDragEnterEvent)。 |
QEvent::DragLeave | 62 | 光标在拖放操作过程中离开部件 (QDragLeaveEvent)。 |
QEvent::DragMove | 61 | 拖放操作正在进行 (QDragMoveEvent)。 |
QEvent::Drop | 63 | 拖放操作已完成 (QDropEvent)。 |
QEvent::DynamicPropertyChange | 170 | 从对象中添加、更改或删除了动态属性。 |
QEvent::EnabledChange | 98 | 部件的启用状态已更改。 |
QEvent::Enter | 10 | 鼠标进入 Widget 的边界 (QEnterEvent)。 |
QEvent::EnterEditFocus | 150 | 编辑器部件获得编辑焦点。必须定义QT_KEYPAD_NAVIGATION 。 |
QEvent::EnterWhatsThisMode | 124 | 当应用程序进入 "这是什么？"模式时发送到顶层部件。 |
QEvent::Expose | 206 | 当窗口的屏幕内容失效并需要从后备存储刷新时，发送到窗口。 |
QEvent::FileOpen | 116 | 文件打开请求 (QFileOpenEvent)。 |
QEvent::FocusIn | 8 | 小工具或窗口获得键盘焦点 (QFocusEvent)。 |
QEvent::FocusOut | 9 | 小工具或窗口失去键盘焦点 (QFocusEvent)。 |
QEvent::FocusAboutToChange | 23 | Widget 或 Window 的焦点即将改变 (QFocusEvent) |
QEvent::FontChange | 97 | Widget 的字体已更改。 |
QEvent::Gesture | 198 | 触发了一个手势 (QGestureEvent)。 |
QEvent::GestureOverride | 202 | 触发了手势覆盖 (QGestureEvent)。 |
QEvent::GrabKeyboard | 188 | 项目获得键盘抓取 (QGraphicsItem only )。 |
QEvent::GrabMouse | 186 | 项目获得鼠标抓取 ( 仅限QGraphicsItem )。 |
QEvent::GraphicsSceneContextMenu | 159 | 在图形场景上弹出上下文菜单 (QGraphicsSceneContextMenuEvent)。 |
QEvent::GraphicsSceneDragEnter | 164 | 光标在拖放操作期间进入图形场景 (QGraphicsSceneDragDropEvent)。 |
QEvent::GraphicsSceneDragLeave | 166 | 光标在拖放操作过程中离开图形场景 (QGraphicsSceneDragDropEvent)。 |
QEvent::GraphicsSceneDragMove | 165 | 场景上正在进行拖放操作 (QGraphicsSceneDragDropEvent)。 |
QEvent::GraphicsSceneDrop | 167 | 场景上的拖放操作已完成 (QGraphicsSceneDragDropEvent)。 |
QEvent::GraphicsSceneHelp | 163 | 用户请求图形场景帮助 (QHelpEvent)。 |
QEvent::GraphicsSceneHoverEnter | 160 | 鼠标光标进入图形场景中的悬停项 (QGraphicsSceneHoverEvent)。 |
QEvent::GraphicsSceneHoverLeave | 162 | 鼠标光标离开图形场景中的悬停项 (QGraphicsSceneHoverEvent)。 |
QEvent::GraphicsSceneHoverMove | 161 | 鼠标光标在图形场景中的悬浮项内移动 (QGraphicsSceneHoverEvent)。 |
QEvent::GraphicsSceneMouseDoubleClick | 158 | 在图形场景中再次按下鼠标（双击） (QGraphicsSceneMouseEvent)。 |
QEvent::GraphicsSceneMouseMove | 155 | 在图形场景中移动鼠标 (QGraphicsSceneMouseEvent)。 |
QEvent::GraphicsSceneMousePress | 156 | 在图形场景中按下鼠标 (QGraphicsSceneMouseEvent)。 |
QEvent::GraphicsSceneMouseRelease | 157 | 在图形场景中释放鼠标 (QGraphicsSceneMouseEvent)。 |
QEvent::GraphicsSceneMove | 182 | 部件被移动 (QGraphicsSceneMoveEvent)。 |
QEvent::GraphicsSceneResize | 181 | 调整了 Widget 的大小 (QGraphicsSceneResizeEvent)。 |
QEvent::GraphicsSceneWheel | 168 | 鼠标滚轮在图形场景中滚动 (QGraphicsSceneWheelEvent)。 |
QEvent::GraphicsSceneLeave | 220 | 光标离开图形场景 (QGraphicsSceneWheelEvent)。 |
QEvent::Hide | 18 | 部件被隐藏 (QHideEvent)。 |
QEvent::HideToParent | 27 | 子部件被隐藏。 |
QEvent::HoverEnter | 127 | 鼠标光标进入悬浮 Widget (QHoverEvent)。 |
QEvent::HoverLeave | 128 | 鼠标光标离开悬浮 Widget (QHoverEvent)。 |
QEvent::HoverMove | 129 | 鼠标指针在悬浮 Widget 内移动 (QHoverEvent)。 |
QEvent::IconDrag | 96 | 窗口的主图标被拖走 (QIconDragEvent)。 |
QEvent::IconTextChange | 101 | 窗口部件的图标文本已更改。(已废弃） |
QEvent::InputMethod | 83 | 正在使用一个输入法 (QInputMethodEvent)。 |
QEvent::InputMethodQuery | 207 | 输入法查询事件 (QInputMethodQueryEvent) |
QEvent::KeyboardLayoutChange | 169 | 键盘布局已更改。 |
QEvent::KeyPress | 6 | 按键按下 (QKeyEvent)。 |
QEvent::KeyRelease | 7 | 按键释放 (QKeyEvent)。 |
QEvent::LanguageChange | 89 | 应用程序翻译已更改。 |
QEvent::LayoutDirectionChange | 90 | 布局方向改变。 |
QEvent::LayoutRequest | 76 | 需要重新设计部件布局。 |
QEvent::Leave | 11 | 鼠标离开部件边界。 |
QEvent::LeaveEditFocus | 151 | 编辑器部件在编辑时失去焦点。必须定义 QT_KEYPAD_NAVIGATION。 |
QEvent::LeaveWhatsThisMode | 125 | 当应用程序离开 "What's This?"（这是什么？ |
QEvent::LocaleChange | 88 | 系统地域已更改。 |
QEvent::NonClientAreaMouseButtonDblClick | 176 | 鼠标双击发生在客户端区域之外 (QMouseEvent)。 |
QEvent::NonClientAreaMouseButtonPress | 174 | 在客户端区域外按下鼠标按钮 (QMouseEvent)。 |
QEvent::NonClientAreaMouseButtonRelease | 175 | 在客户端区域外释放了鼠标按钮 (QMouseEvent)。 |
QEvent::NonClientAreaMouseMove | 173 | 在客户端区域外移动了鼠标 (QMouseEvent)。 |
QEvent::MacSizeChange | 177 | 用户更改了部件尺寸（仅限 macOS）。 |
QEvent::MetaCall | 43 | 通过QMetaObject::invokeMethod() 调用异步方法。 |
QEvent::ModifiedChange | 102 | 部件修改状态已更改。 |
QEvent::MouseButtonDblClick | 4 | 再次按下鼠标 (QMouseEvent)。 |
QEvent::MouseButtonPress | 2 | 鼠标按下 (QMouseEvent)。 |
QEvent::MouseButtonRelease | 3 | 释放鼠标 (QMouseEvent)。 |
QEvent::MouseMove | 5 | 鼠标移动 (QMouseEvent)。 |
QEvent::MouseTrackingChange | 109 | 鼠标跟踪状态已更改。 |
QEvent::Move | 13 | Widget 的位置发生变化 (QMoveEvent)。 |
QEvent::NativeGesture | 197 | 系统检测到一个手势 (QNativeGestureEvent)。 |
QEvent::OrientationChange | 208 | 屏幕方向发生变化 ( QScreenOrientationChangeEvent )。 |
QEvent::Paint | 12 | 需要更新屏幕 (QPaintEvent)。 |
QEvent::PaletteChange | 39 | 部件的调色板发生变化。 |
QEvent::ParentAboutToChange | 131 | 对象的父对象即将改变。仅发送给某些对象类型，如QWidget 。 |
QEvent::ParentChange | 21 | 对象父级已更改。仅发送到某些对象类型，如QWidget 。 |
QEvent::ParentWindowAboutToChange (since Qt 6.7) | 225 | 父窗口即将更改。 |
QEvent::ParentWindowChange (since Qt 6.7) | 226 | 父窗口已更改。 |
QEvent::PlatformPanel | 212 | 已请求平台专用面板。 |
QEvent::PlatformSurface | 217 | 已创建或即将销毁一个本地平台表面 (QPlatformSurfaceEvent)。 |
QEvent::Polish | 75 | 部件已抛光。 |
QEvent::PolishRequest | 74 | 该窗口部件应抛光。 |
QEvent::QueryWhatsThis | 123 | 如果有 "这是什么？"帮助，小部件应接受该事件 (QHelpEvent)。 |
QEvent::Quit | 20 | 应用程序已退出。 |
QEvent::ReadOnlyChange (since Qt 5.4) | 106 | Widget 的只读状态已更改。 |
QEvent::RequestSoftwareInputPanel | 199 | Widget 想要打开软件输入面板 (SIP)。 |
QEvent::Resize | 14 | Widget 的大小发生变化 (QResizeEvent)。 |
QEvent::ScrollPrepare | 204 | 对象需要填写几何信息 (QScrollPrepareEvent)。 |
QEvent::Scroll | 205 | 对象需要滚动到提供的位置 (QScrollEvent)。 |
QEvent::Shortcut | 117 | 子对象中的按键，用于处理快捷键 (QShortcutEvent)。 |
QEvent::ShortcutOverride | 51 | 子对象中的按键，用于覆盖快捷键处理 (QKeyEvent)。当快捷键即将触发时，ShortcutOverride 发送到活动窗口。这样，客户端（如窗口小部件）就可以通过接受该事件，发出它们将自行处理快捷键的信号。如果接受了快捷方式覆盖，事件就会以普通按键的方式发送到焦点窗口部件。否则，它会触发快捷操作（如果存在的话）。 |
QEvent::Show | 17 | 部件已显示在屏幕上 (QShowEvent)。 |
QEvent::ShowToParent | 26 | 已显示一个子部件。 |
QEvent::SockAct | 50 | 套接字已激活，用于实现QSocketNotifier 。 |
QEvent::StateMachineSignal | 192 | 向状态机发送信号 (QStateMachine::SignalEvent)。 |
QEvent::StateMachineWrapped | 193 | 事件是另一个事件的包装器，即包含另一个事件 (QStateMachine::WrappedEvent)。 |
QEvent::StatusTip | 112 | 请求状态提示 (QStatusTipEvent)。 |
QEvent::StyleChange | 100 | 小工具的样式已更改。 |
QEvent::TabletMove | 87 | Wacom 手写板移动 (QTabletEvent)。 |
QEvent::TabletPress | 92 | Wacom 手写板按下 (QTabletEvent)。 |
QEvent::TabletRelease | 93 | Wacom 平板电脑发布 (QTabletEvent)。 |
QEvent::TabletEnterProximity | 171 | Wacom 平板电脑进入近距离事件 (QTabletEvent), 发送到QApplication 。 |
QEvent::TabletLeaveProximity | 172 | Wacom 手写板离开近距离事件 (QTabletEvent)，发送至QApplication 。 |
QEvent::TabletTrackingChange (since Qt 5.9) | 219 | Wacom 手写板跟踪状态已更改。 |
QEvent::ThreadChange | 22 | 对象被移动到另一个线程。这是在前一个线程中发送给该对象的最后一个事件。请参见QObject::moveToThread( )。 |
QEvent::Timer | 1 | 常规计时器事件 (QTimerEvent)。 |
QEvent::ToolBarChange | 120 | 在 macOS 上切换工具栏按钮。 |
QEvent::ToolTip | 110 | 要求提供工具提示 (QHelpEvent)。 |
QEvent::ToolTipChange | 184 | 部件的工具提示已更改。 |
QEvent::TouchBegin | 194 | 触摸屏或轨迹板事件序列开始 (QTouchEvent)。 |
QEvent::TouchCancel | 209 | 取消触摸事件序列 (QTouchEvent)。 |
QEvent::TouchEnd | 196 | 触摸事件序列结束 (QTouchEvent)。 |
QEvent::TouchUpdate | 195 | 触摸屏事件 (QTouchEvent)。 |
QEvent::UngrabKeyboard | 189 | 项目失去键盘抓取 (QGraphicsItem only )。 |
QEvent::UngrabMouse | 187 | 项目失去鼠标抓取 (QGraphicsItem,QQuickItem)。 |
QEvent::UpdateLater | 78 | 部件应排队等待稍后重新绘制。 |
QEvent::UpdateRequest | 77 | 部件应重新绘制。 |
QEvent::WhatsThis | 111 | 小工具应显示 "这是什么？"帮助 (QHelpEvent)。 |
QEvent::WhatsThisClicked | 118 | 点击了部件的 "这是什么？"帮助中的链接。 |
QEvent::Wheel | 31 | 鼠标滚轮滚动 (QWheelEvent)。 |
QEvent::WinEventAct | 132 | 发生了 Windows 特有的激活事件。 |
QEvent::WindowActivate | 24 | 窗口被激活。 |
QEvent::WindowBlocked | 103 | 窗口被模式对话框阻止。 |
QEvent::WindowDeactivate | 25 | 窗口已停用。 |
QEvent::WindowIconChange | 34 | 窗口图标已更改。 |
QEvent::WindowStateChange | 105 | window's state （最小化、最大化或全屏）已更改 (QWindowStateChangeEvent)。 |
QEvent::WindowTitleChange | 33 | 窗口标题已更改。 |
QEvent::WindowUnblocked | 104 | 退出模式对话框后，窗口已解除锁定。 |
QEvent::WinIdChange | 203 | 本机窗口部件的窗口系统标识符已更改。 |
QEvent::ZOrderChange | 126 | 窗口部件的 Z 排序已更改。此事件不会发送到顶层窗口。 |
QEvent::SafeAreaMarginsChange (since Qt 6.9) | 227 | 窗口的安全区域边距已更改。 |
用户事件的值应介于User 和MaxUser 之间：
| 常量 | 值 | 说明 |
|---|---|---|
QEvent::User | 1000 | 用户自定义事件。 |
QEvent::MaxUser | 65535 | 最后一个用户事件 ID。 |
为方便起见，您可以使用registerEventType() 函数为您的应用程序注册和保留自定义事件类型。这样做可以避免意外重复使用应用程序中其他地方已在使用的自定义事件类型。
属性文档
accepted : bool
该属性包含事件对象的接受标志。
设置接受参数表示事件接收者希望接收该事件。不想要的事件可能会传播到父 widget。默认情况下，isAccepted() 设置为 true，但不要依赖于此，因为子类可能会选择在构造函数中清除它。
为方便起见，也可以使用accept() 设置接受标志，使用ignore() 清除接受标志。
注意： 接受QPointerEvent 会隐式地accepts 该事件携带的所有points 。
访问函数：
| bool | isAccepted() const |
| virtual void | setAccepted(bool accepted) |
成员函数文档
[explicit] QEvent::QEvent(QEvent::Type type)
构造type 类型的事件对象。
[virtual noexcept] QEvent::~QEvent()
销毁事件。如果它是posted ，则会从要发布的事件列表中删除。
void QEvent::accept()
设置事件对象的接受标志，相当于调用setAccepted(true)。
设置接受参数表示事件接收者希望接收该事件。不想要的事件可能会传播到父 widget。
另请参阅 ignore().
[virtual, since 6.0] QEvent *QEvent::clone() const
创建并返回此事件的一个相同副本。
此函数在 Qt 6.0 中引入。
void QEvent::ignore()
清除事件对象的接受标志参数，相当于调用setAccepted(false)。
清除接受参数表示事件接收者不需要该事件。不想要的事件可能会传播到父 widget。
另请参阅 accept().
[noexcept, since 6.0] bool QEvent::isInputEvent() const
如果事件对象是QInputEvent 或其子类之一，则返回true 。
此函数在 Qt 6.0 中引入。
[noexcept, since 6.0] bool QEvent::isPointerEvent() const
如果事件对象是QPointerEvent 或其子类之一，则返回true 。
此函数在 Qt 6.0 中引入。
[noexcept, since 6.0] bool QEvent::isSinglePointEvent() const
如果事件对象是QSinglePointEvent 的子类，则返回true 。
此函数在 Qt 6.0 中引入。
[static noexcept] int QEvent::registerEventType(int hint = -1)
注册并返回自定义事件类型。如果提供的hint 可用，则使用该值，否则将返回介于QEvent::User 和QEvent::MaxUser 之间、尚未注册的值。如果hint 的值不在QEvent::User 和QEvent::MaxUser 之间，则会被忽略。
如果所有可用值都已被占用或程序正在关闭，则返回-1。
注意：此函数是线程安全的。
bool QEvent::spontaneous() const
如果事件源于应用程序之外（系统事件），则返回true ；否则返回false 。
QEvent::Type QEvent::type() const
返回事件类型。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
