首页 > 代码库 > QEvent大全,有中文解释

QEvent大全,有中文解释

简述

QEvent 类是所有事件类的基类,事件对象包含事件参数。

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 只包含了一个事件类型参数。QEvent 的子类包含了额外的描述特定事件的参数。

 

  • 简述
  • 成员类型
  • 属性文档
  • 成员函数文档
  • 更多参考

 

成员类型

枚举QEvent::Type:

这个枚举类型定义了Qt中有效的事件类型。事件类型和每个类型的专门类如下:

常量描述
QEvent::None0不是一个事件
QEvent::ActionAdded114一个新 action 被添加(QActionEvent)
QEvent::ActionChanged113一个 action 被改变(QActionEvent)
QEvent::ActionRemoved115一个 action 被移除(QActionEvent)
QEvent::ActivationChange99Widget 的顶层窗口激活状态发生了变化
QEvent::ApplicationActivate121这个枚举已被弃用,使用 ApplicationStateChange 代替
QEvent::ApplicationActivatedApplicationActivate这个枚举已被弃用,使用 ApplicationStateChange 代替
QEvent::ApplicationDeactivate122这个枚举已被弃用,使用 ApplicationStateChange 代替
QEvent::ApplicationFontChange36应用程序的默认字体发生了变化
QEvent::ApplicationLayoutDirectionChange37应用程序的默认布局方向发生了变化
QEvent::ApplicationPaletteChange38应用程序的默认调色板发生了变化
QEvent::ApplicationStateChange214应用程序的状态发生了变化
QEvent::ApplicationWindowIconChange35应用程序的图标发生了变化
QEvent::ChildAdded68一个对象获得孩子(QChildEvent)
QEvent::ChildPolished69一个部件的孩子被抛光(QChildEvent)
QEvent::ChildRemoved71一个对象时区孩子(QChildEvent)
QEvent::Clipboard40剪贴板的内容发生改变
QEvent::Close19Widget 被关闭(QCloseEvent)
QEvent::CloseSoftwareInputPanel200一个部件要关闭软件输入面板(SIP)
QEvent::ContentsRectChange178部件内容区域的外边距发生改变
QEvent::ContextMenu82上下文弹出菜单(QContextMenuEvent)
QEvent::CursorChange183部件的鼠标发生改变
QEvent::DeferredDelete52对象被清除后将被删除(QDeferredDeleteEvent)
QEvent::DragEnter60在拖放操作期间鼠标进入窗口部件(QDragEnterEvent)
QEvent::DragLeave62在拖放操作期间鼠标离开窗口部件(QDragLeaveEvent)
QEvent::DragMove61拖放操作正在进行(QDragMoveEvent)
QEvent::Drop63拖放操作完成(QDropEvent)
QEvent::DynamicPropertyChange170动态属性已添加、更改或从对象中删除
QEvent::EnabledChange98部件的 enabled 状态已更改
QEvent::Enter10鼠标进入部件的边界(QEnterEvent)
QEvent::EnterEditFocus150编辑部件获得焦点进行编辑,必须定义 QT_KEYPAD_NAVIGATION
QEvent::EnterWhatsThisMode124当应用程序进入“What’s This?”模式,发送到 toplevel 顶层部件
QEvent::Expose206当其屏幕上的内容无效,发送到窗口,并需要从后台存储刷新
QEvent::FileOpen116文件打开请求(QFileOpenEvent)
QEvent::FocusIn8部件或窗口获得键盘焦点(QFocusEvent)
QEvent::FocusOut9部件或窗口失去键盘焦点(QFocusEvent)
QEvent::FocusAboutToChange23部件或窗口焦点即将改变(QFocusEvent)
QEvent::FontChange97部件的字体发生改变
QEvent::Gesture198触发了一个手势(QGestureEvent)
QEvent::GestureOverride202触发了手势覆盖(QGestureEvent)
QEvent::GrabKeyboard188Item 获得键盘抓取(仅限 QGraphicsItem)
QEvent::GrabMouse186项目获得鼠标抓取(仅限 QGraphicsItem)
QEvent::GraphicsSceneContextMenu159在图形场景上的上下文弹出菜单(QGraphicsScene ContextMenuEvent)
QEvent::GraphicsSceneDragEnter164在拖放操作期间,鼠标进入图形场景(QGraphicsSceneDragDropEvent)
QEvent::GraphicsSceneDragLeave166在拖放操作期间鼠标离开图形场景(QGraphicsSceneDragDropEvent)
QEvent::GraphicsSceneDragMove165在场景上正在进行拖放操作(QGraphicsSceneDragDropEvent)
QEvent::GraphicsSceneDrop167在场景上完成拖放操作(QGraphicsSceneDragDropEvent)
QEvent::GraphicsSceneHelp163用户请求图形场景的帮助(QHelpEvent)
QEvent::GraphicsSceneHoverEnter160鼠标进入图形场景中的悬停项(QGraphicsSceneHoverEvent)
QEvent::GraphicsSceneHoverLeave162鼠标离开图形场景中一个悬停项(QGraphicsSceneHoverEvent)
QEvent::GraphicsSceneHoverMove161鼠标在图形场景中的悬停项内移动(QGraphicsSceneHoverEvent)
QEvent::GraphicsSceneMouseDoubleClick158鼠标在图形场景中再次按下(双击)(QGraphicsSceneMouseEvent)
QEvent::GraphicsSceneMouseMove155鼠标在图形场景中移动(QGraphicsSceneMouseEvent)
QEvent::GraphicsSceneMousePress156鼠标在图形场景中按下(QGraphicsSceneMouseEvent)
QEvent::GraphicsSceneMouseRelease157鼠标在图形场景中释放(QGraphicsSceneMouseEvent)
QEvent::GraphicsSceneMove182部件被移动(QGraphicsSceneMoveEvent)
QEvent::GraphicsSceneResize181部件已调整大小(QGraphicsSceneResizeEvent)
QEvent::GraphicsSceneWheel168鼠标滚轮在图形场景中滚动(QGraphicsSceneWheelEvent)
QEvent::Hide18部件被隐藏(QHideEvent)
QEvent::HideToParent27子部件被隐藏(QHideEvent)
QEvent::HoverEnter127鼠标进入悬停部件(QHoverEvent)
QEvent::HoverLeave128鼠标留离开悬停部件(QHoverEvent)
QEvent::HoverMove129鼠标在悬停部件内移动(QHoverEvent)
QEvent::IconDrag96窗口的主图标被拖走(QIconDragEvent)
QEvent::IconTextChange101部件的图标文本发生改变(已弃用)
QEvent::InputMethod83正在使用输入法(QInputMethodEvent)
QEvent::InputMethodQuery207输入法查询事件(QInputMethodQueryEvent)
QEvent::KeyboardLayoutChange169键盘布局已更改
QEvent::KeyPress6键盘按下(QKeyEvent)
QEvent::KeyRelease7键盘释放(QKeyEvent)
QEvent::LanguageChange89应用程序翻译发生改变
QEvent::LayoutDirectionChange90布局的方向发生改变
QEvent::LayoutRequest76部件的布局需要重做
QEvent::Leave11鼠标离开部件的边界
QEvent::LeaveEditFocus151编辑部件失去编辑的焦点,必须定义 QT_KEYPAD_NAVIGATION
QEvent::LeaveWhatsThisMode125当应用程序离开“What’s This?”模式,发送到顶层部件
QEvent::LocaleChange88系统区域设置发生改变
QEvent::NonClientAreaMouseButtonDblClick176鼠标双击发生在客户端区域外
QEvent::NonClientAreaMouseButtonPress174鼠标按钮按下发生在客户端区域外
QEvent::NonClientAreaMouseButtonRelease175鼠标按钮释放发生在客户端区域外
QEvent::NonClientAreaMouseMove173鼠标移动发生在客户区域外
QEvent::MacSizeChange177用户更改了部件的大小(仅限 OS X)
QEvent::MetaCall43通过 QMetaObject::invokeMethod() 调用异步方法
QEvent::ModifiedChange102部件修改状态发生改变
QEvent::MouseButtonDblClick4鼠标再次按下(QMouseEvent)
QEvent::MouseButtonPress2鼠标按下(QMouseEvent)
QEvent::MouseButtonRelease3鼠标释放(QMouseEvent)
QEvent::MouseMove5鼠标移动(QMouseEvent)
QEvent::MouseTrackingChange109鼠标跟踪状态发生改变
QEvent::Move13部件的位置发生改变(QMoveEvent)
QEvent::NativeGesture197系统检测到手势(QNativeGestureEvent)
QEvent::OrientationChange208屏幕方向发生改变(QScreenOrientationChangeEvent)
QEvent::Paint12需要屏幕更新(QPaintEvent)
QEvent::PaletteChange39部件的调色板发生改变
QEvent::ParentAboutToChange131部件的 parent 将要更改
QEvent::ParentChange21部件的 parent 发生改变
QEvent::PlatformPanel212请求一个特定于平台的面板
QEvent::PlatformSurface217原生平台表面已创建或即将被销毁(QPlatformSurfaceEvent)
QEvent::Polish75部件被抛光
QEvent::PolishRequest74部件应该被抛光
QEvent::QueryWhatsThis123如果部件有“What’s This?”帮助,应该接受事件
QEvent::ReadOnlyChange106部件的 read-only 状态发生改变
QEvent::RequestSoftwareInputPanel199部件想要打开软件输入面板(SIP)
QEvent::Resize14部件的大小发生改变(QResizeEvent)
QEvent::ScrollPrepare204对象需要填充它的几何信息(QScrollPrepareEvent)
QEvent::Scroll205对象需要滚动到提供的位置(QScrollEvent)
QEvent::Shortcut117快捷键处理(QShortcutEvent)
QEvent::ShortcutOverride51按下按键,用于覆盖快捷键(QKeyEvent)
QEvent::Show17部件显示在屏幕上(QShowEvent)
QEvent::ShowToParent26子部件被显示
QEvent::SockAct50Socket 激活,用于实现 QSocketNotifier
QEvent::StateMachineSignal192信号被传递到状态机(QStateMachine::SignalEvent)
QEvent::StateMachineWrapped193事件是一个包装器,用于包含另一个事件(QStateMachine::WrappedEvent)
QEvent::StatusTip112状态提示请求(QStatusTipEvent)
QEvent::StyleChange100部件的样式发生改变
QEvent::TabletMove87Wacom 写字板移动(QTabletEvent)
QEvent::TabletPress92Wacom 写字板按下(QTabletEvent)
QEvent::TabletRelease93Wacom 写字板释放(QTabletEvent)
QEvent::OkRequest94Ok 按钮在装饰前被按下,仅支持 Windows CE
QEvent::TabletEnterProximity171Wacom 写字板进入接近事件(QTabletEvent),发送到 QApplication
QEvent::TabletLeaveProximity172Wacom 写字板离开接近事件(QTabletEvent),发送到 QApplication
QEvent::ThreadChange22对象被移动到另一个线程。这是发送到此对象的最后一个事件在上一个线程中,参见:QObject::moveToThread()
QEvent::Timer1定时器事件(QTimerEvent)
QEvent::ToolBarChange120工具栏按钮在 OS X 上进行切换
QEvent::ToolTip110一个 tooltip 请求(QHelpEvent)
QEvent::ToolTipChange184部件的 tooltip 发生改变
QEvent::TouchBegin194触摸屏或轨迹板事件序列的开始(QTouchEvent)
QEvent::TouchCancel209取消触摸事件序列(QTouchEvent)
QEvent::TouchEnd196触摸事件序列结束(QTouchEvent)
QEvent::TouchUpdate195触摸屏事件(QTouchEvent)
QEvent::UngrabKeyboard189Item 失去键盘抓取(QGraphicsItem)
QEvent::UngrabMouse187Item 失去鼠标抓取(QGraphicsItem、QQuickItem)
QEvent::UpdateLater78部件应该排队在以后重新绘制
QEvent::UpdateRequest77部件应该被重绘
QEvent::WhatsThis111部件应该显示“What’s This”帮助(QHelpEvent)
QEvent::WhatsThisClicked118部件的“What’s This”帮助链接被点击
QEvent::Wheel31鼠标滚轮滚动(QWheelEvent)
QEvent::WinEventAct132发生了 Windows 特定的激活事件
QEvent::WindowActivate24窗口已激活
QEvent::WindowBlocked103窗口被模态对话框阻塞
QEvent::WindowDeactivate25窗户被停用
QEvent::WindowIconChange34窗口的图标发生改变
QEvent::WindowStateChange105窗口的状态(最小化、最大化或全屏)发生改变(QWindowStateChangeEvent)
QEvent::WindowTitleChange33窗口的标题发生改变
QEvent::WindowUnblocked104一个模态对话框退出后,窗口将不被阻塞
QEvent::WinIdChange203本地窗口的系统标识符发生改变
QEvent::ZOrderChange126部件的 z 值发生了改变,该事件不会发送给顶层窗口

用户事件的值应该介于 User 和 MaxUser 之间。

常量描述
QEvent::User1000用户定义的事件
QEvent::MaxUser65535最后的用户事件 ID

为方便起见,可以使用 registerEventType() 函数来注册和存储一个自定义事件类型,这样做会避免意外地重用一个自定义事件类型。

属性文档

accepted : bool

设置 accept 标志意味着接收器需要该事件,不需要的事件可能会被传递给它的父窗口。默认情况下,isAccepted() 设置为 true。不能依赖于此,因为子类可能会在子类构造器中清除该标志。

出于简便考虑,accept 标志可以通过 accept() 设置,ignore() 清除。

访问函数:

  • bool isAccepted() const
  • void setAccepted(bool accepted)

成员函数文档

    • void QEvent::accept() 
      设置事件对象的 accept 标志,等价于 setAccepted(true)。

      设置 accept 标志意味着接收器需要该事件,不需要的事件可能会被传递给它的父窗口。

    • void QEvent::ignore() 
      清除事件对象的 accept 标志,等价于 setAccepted(false)。

      清除 accept 标志意味着事件接收器不需要该事件,不需要的事件可能会被传递给它的父窗口。

    • [static] int QEvent::registerEventType(int hint = -1) 
      注册并返回一个自定义事件类型。如果 hint 是合法的,则会返回这个值;否则,会返回介于 QEvent::User 和 QEvent::MaxUser 之间的一个尚未被注册的值。如果其值不在 QEvent::User 和 QEvent::MaxUser 之间,hint 值将被忽略。

      如果可用的值被使用或程序关闭,将返回 -1。该函数是线程安全的。

    • bool QEvent::spontaneous() const 
      如果事件由应用程序之外产生的,比如一个系统事件,返回 true,否则返回 false。

      对于绘制事件,该函数的返回值是未定义的。

    • Type QEvent::type() const 
      返回事件的类型

 

http://blog.csdn.net/u011012932/article/details/51933153

QEvent大全,有中文解释