Qt 之 QEvent

向右看齐 2022-08-31 15:17 82阅读 0赞

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

*  [简述][Link 1]
 *  [成员类型][Link 2]
 *  [属性文档][Link 3]
 *  [成员函数文档][Link 4]

# 成员类型 #

枚举QEvent::Type：

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

<table> 
 <thead> 
  <tr> 
   <th>常量</th> 
   <th>值</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>QEvent::None</td> 
   <td>0</td> 
   <td>不是一个事件</td> 
  </tr> 
  <tr> 
   <td>QEvent::ActionAdded</td> 
   <td>114</td> 
   <td>一个新 action 被添加（QActionEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ActionChanged</td> 
   <td>113</td> 
   <td>一个 action 被改变（QActionEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ActionRemoved</td> 
   <td>115</td> 
   <td>一个 action 被移除（QActionEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ActivationChange</td> 
   <td>99</td> 
   <td>Widget 的顶层窗口激活状态发生了变化</td> 
  </tr> 
  <tr> 
   <td>QEvent::ApplicationActivate</td> 
   <td>121</td> 
   <td>这个枚举已被弃用，使用 ApplicationStateChange 代替</td> 
  </tr> 
  <tr> 
   <td>QEvent::ApplicationActivated</td> 
   <td>ApplicationActivate</td> 
   <td>这个枚举已被弃用，使用 ApplicationStateChange 代替</td> 
  </tr> 
  <tr> 
   <td>QEvent::ApplicationDeactivate</td> 
   <td>122</td> 
   <td>这个枚举已被弃用，使用 ApplicationStateChange 代替</td> 
  </tr> 
  <tr> 
   <td>QEvent::ApplicationFontChange</td> 
   <td>36</td> 
   <td>应用程序的默认字体发生了变化</td> 
  </tr> 
  <tr> 
   <td>QEvent::ApplicationLayoutDirectionChange</td> 
   <td>37</td> 
   <td>应用程序的默认布局方向发生了变化</td> 
  </tr> 
  <tr> 
   <td>QEvent::ApplicationPaletteChange</td> 
   <td>38</td> 
   <td>应用程序的默认调色板发生了变化</td> 
  </tr> 
  <tr> 
   <td>QEvent::ApplicationStateChange</td> 
   <td>214</td> 
   <td>应用程序的状态发生了变化</td> 
  </tr> 
  <tr> 
   <td>QEvent::ApplicationWindowIconChange</td> 
   <td>35</td> 
   <td>应用程序的图标发生了变化</td> 
  </tr> 
  <tr> 
   <td>QEvent::ChildAdded</td> 
   <td>68</td> 
   <td>一个对象获得孩子（QChildEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ChildPolished</td> 
   <td>69</td> 
   <td>一个部件的孩子被抛光（QChildEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ChildRemoved</td> 
   <td>71</td> 
   <td>一个对象时区孩子（QChildEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::Clipboard</td> 
   <td>40</td> 
   <td>剪贴板的内容发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::Close</td> 
   <td>19</td> 
   <td>Widget 被关闭（QCloseEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::CloseSoftwareInputPanel</td> 
   <td>200</td> 
   <td>一个部件要关闭软件输入面板（SIP）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ContentsRectChange</td> 
   <td>178</td> 
   <td>部件内容区域的外边距发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::ContextMenu</td> 
   <td>82</td> 
   <td>上下文弹出菜单（QContextMenuEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::CursorChange</td> 
   <td>183</td> 
   <td>部件的鼠标发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::DeferredDelete</td> 
   <td>52</td> 
   <td>对象被清除后将被删除（QDeferredDeleteEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::DragEnter</td> 
   <td>60</td> 
   <td>在拖放操作期间鼠标进入窗口部件（QDragEnterEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::DragLeave</td> 
   <td>62</td> 
   <td>在拖放操作期间鼠标离开窗口部件（QDragLeaveEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::DragMove</td> 
   <td>61</td> 
   <td>拖放操作正在进行（QDragMoveEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::Drop</td> 
   <td>63</td> 
   <td>拖放操作完成（QDropEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::DynamicPropertyChange</td> 
   <td>170</td> 
   <td>动态属性已添加、更改或从对象中删除</td> 
  </tr> 
  <tr> 
   <td>QEvent::EnabledChange</td> 
   <td>98</td> 
   <td>部件的 enabled 状态已更改</td> 
  </tr> 
  <tr> 
   <td>QEvent::Enter</td> 
   <td>10</td> 
   <td>鼠标进入部件的边界（QEnterEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::EnterEditFocus</td> 
   <td>150</td> 
   <td>编辑部件获得焦点进行编辑，必须定义 QT_KEYPAD_NAVIGATION</td> 
  </tr> 
  <tr> 
   <td>QEvent::EnterWhatsThisMode</td> 
   <td>124</td> 
   <td>当应用程序进入“What’s This?”模式，发送到 toplevel 顶层部件</td> 
  </tr> 
  <tr> 
   <td>QEvent::Expose</td> 
   <td>206</td> 
   <td>当其屏幕上的内容无效，发送到窗口，并需要从后台存储刷新</td> 
  </tr> 
  <tr> 
   <td>QEvent::FileOpen</td> 
   <td>116</td> 
   <td>文件打开请求（QFileOpenEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::FocusIn</td> 
   <td>8</td> 
   <td>部件或窗口获得键盘焦点（QFocusEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::FocusOut</td> 
   <td>9</td> 
   <td>部件或窗口失去键盘焦点（QFocusEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::FocusAboutToChange</td> 
   <td>23</td> 
   <td>部件或窗口焦点即将改变（QFocusEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::FontChange</td> 
   <td>97</td> 
   <td>部件的字体发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::Gesture</td> 
   <td>198</td> 
   <td>触发了一个手势（QGestureEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GestureOverride</td> 
   <td>202</td> 
   <td>触发了手势覆盖（QGestureEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GrabKeyboard</td> 
   <td>188</td> 
   <td>Item 获得键盘抓取（仅限 QGraphicsItem）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GrabMouse</td> 
   <td>186</td> 
   <td>项目获得鼠标抓取（仅限 QGraphicsItem）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneContextMenu</td> 
   <td>159</td> 
   <td>在图形场景上的上下文弹出菜单（QGraphicsScene ContextMenuEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneDragEnter</td> 
   <td>164</td> 
   <td>在拖放操作期间，鼠标进入图形场景（QGraphicsSceneDragDropEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneDragLeave</td> 
   <td>166</td> 
   <td>在拖放操作期间鼠标离开图形场景（QGraphicsSceneDragDropEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneDragMove</td> 
   <td>165</td> 
   <td>在场景上正在进行拖放操作（QGraphicsSceneDragDropEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneDrop</td> 
   <td>167</td> 
   <td>在场景上完成拖放操作（QGraphicsSceneDragDropEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneHelp</td> 
   <td>163</td> 
   <td>用户请求图形场景的帮助（QHelpEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneHoverEnter</td> 
   <td>160</td> 
   <td>鼠标进入图形场景中的悬停项（QGraphicsSceneHoverEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneHoverLeave</td> 
   <td>162</td> 
   <td>鼠标离开图形场景中一个悬停项（QGraphicsSceneHoverEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneHoverMove</td> 
   <td>161</td> 
   <td>鼠标在图形场景中的悬停项内移动（QGraphicsSceneHoverEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneMouseDoubleClick</td> 
   <td>158</td> 
   <td>鼠标在图形场景中再次按下（双击）（QGraphicsSceneMouseEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneMouseMove</td> 
   <td>155</td> 
   <td>鼠标在图形场景中移动（QGraphicsSceneMouseEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneMousePress</td> 
   <td>156</td> 
   <td>鼠标在图形场景中按下（QGraphicsSceneMouseEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneMouseRelease</td> 
   <td>157</td> 
   <td>鼠标在图形场景中释放（QGraphicsSceneMouseEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneMove</td> 
   <td>182</td> 
   <td>部件被移动（QGraphicsSceneMoveEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneResize</td> 
   <td>181</td> 
   <td>部件已调整大小（QGraphicsSceneResizeEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::GraphicsSceneWheel</td> 
   <td>168</td> 
   <td>鼠标滚轮在图形场景中滚动（QGraphicsSceneWheelEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::Hide</td> 
   <td>18</td> 
   <td>部件被隐藏（QHideEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::HideToParent</td> 
   <td>27</td> 
   <td>子部件被隐藏（QHideEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::HoverEnter</td> 
   <td>127</td> 
   <td>鼠标进入悬停部件（QHoverEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::HoverLeave</td> 
   <td>128</td> 
   <td>鼠标留离开悬停部件（QHoverEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::HoverMove</td> 
   <td>129</td> 
   <td>鼠标在悬停部件内移动（QHoverEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::IconDrag</td> 
   <td>96</td> 
   <td>窗口的主图标被拖走（QIconDragEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::IconTextChange</td> 
   <td>101</td> 
   <td>部件的图标文本发生改变（已弃用）</td> 
  </tr> 
  <tr> 
   <td>QEvent::InputMethod</td> 
   <td>83</td> 
   <td>正在使用输入法（QInputMethodEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::InputMethodQuery</td> 
   <td>207</td> 
   <td>输入法查询事件（QInputMethodQueryEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::KeyboardLayoutChange</td> 
   <td>169</td> 
   <td>键盘布局已更改</td> 
  </tr> 
  <tr> 
   <td>QEvent::KeyPress</td> 
   <td>6</td> 
   <td>键盘按下（QKeyEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::KeyRelease</td> 
   <td>7</td> 
   <td>键盘释放（QKeyEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::LanguageChange</td> 
   <td>89</td> 
   <td>应用程序翻译发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::LayoutDirectionChange</td> 
   <td>90</td> 
   <td>布局的方向发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::LayoutRequest</td> 
   <td>76</td> 
   <td>部件的布局需要重做</td> 
  </tr> 
  <tr> 
   <td>QEvent::Leave</td> 
   <td>11</td> 
   <td>鼠标离开部件的边界</td> 
  </tr> 
  <tr> 
   <td>QEvent::LeaveEditFocus</td> 
   <td>151</td> 
   <td>编辑部件失去编辑的焦点，必须定义 QT_KEYPAD_NAVIGATION</td> 
  </tr> 
  <tr> 
   <td>QEvent::LeaveWhatsThisMode</td> 
   <td>125</td> 
   <td>当应用程序离开“What’s This?”模式，发送到顶层部件</td> 
  </tr> 
  <tr> 
   <td>QEvent::LocaleChange</td> 
   <td>88</td> 
   <td>系统区域设置发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::NonClientAreaMouseButtonDblClick</td> 
   <td>176</td> 
   <td>鼠标双击发生在客户端区域外</td> 
  </tr> 
  <tr> 
   <td>QEvent::NonClientAreaMouseButtonPress</td> 
   <td>174</td> 
   <td>鼠标按钮按下发生在客户端区域外</td> 
  </tr> 
  <tr> 
   <td>QEvent::NonClientAreaMouseButtonRelease</td> 
   <td>175</td> 
   <td>鼠标按钮释放发生在客户端区域外</td> 
  </tr> 
  <tr> 
   <td>QEvent::NonClientAreaMouseMove</td> 
   <td>173</td> 
   <td>鼠标移动发生在客户区域外</td> 
  </tr> 
  <tr> 
   <td>QEvent::MacSizeChange</td> 
   <td>177</td> 
   <td>用户更改了部件的大小（仅限 OS X）</td> 
  </tr> 
  <tr> 
   <td>QEvent::MetaCall</td> 
   <td>43</td> 
   <td>通过 QMetaObject::invokeMethod() 调用异步方法</td> 
  </tr> 
  <tr> 
   <td>QEvent::ModifiedChange</td> 
   <td>102</td> 
   <td>部件修改状态发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::MouseButtonDblClick</td> 
   <td>4</td> 
   <td>鼠标再次按下（QMouseEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::MouseButtonPress</td> 
   <td>2</td> 
   <td>鼠标按下（QMouseEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::MouseButtonRelease</td> 
   <td>3</td> 
   <td>鼠标释放（QMouseEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::MouseMove</td> 
   <td>5</td> 
   <td>鼠标移动（QMouseEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::MouseTrackingChange</td> 
   <td>109</td> 
   <td>鼠标跟踪状态发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::Move</td> 
   <td>13</td> 
   <td>部件的位置发生改变（QMoveEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::NativeGesture</td> 
   <td>197</td> 
   <td>系统检测到手势（QNativeGestureEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::OrientationChange</td> 
   <td>208</td> 
   <td>屏幕方向发生改变（QScreenOrientationChangeEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::Paint</td> 
   <td>12</td> 
   <td>需要屏幕更新（QPaintEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::PaletteChange</td> 
   <td>39</td> 
   <td>部件的调色板发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::ParentAboutToChange</td> 
   <td>131</td> 
   <td>部件的 parent 将要更改</td> 
  </tr> 
  <tr> 
   <td>QEvent::ParentChange</td> 
   <td>21</td> 
   <td>部件的 parent 发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::PlatformPanel</td> 
   <td>212</td> 
   <td>请求一个特定于平台的面板</td> 
  </tr> 
  <tr> 
   <td>QEvent::PlatformSurface</td> 
   <td>217</td> 
   <td>原生平台表面已创建或即将被销毁（QPlatformSurfaceEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::Polish</td> 
   <td>75</td> 
   <td>部件被抛光</td> 
  </tr> 
  <tr> 
   <td>QEvent::PolishRequest</td> 
   <td>74</td> 
   <td>部件应该被抛光</td> 
  </tr> 
  <tr> 
   <td>QEvent::QueryWhatsThis</td> 
   <td>123</td> 
   <td>如果部件有“What’s This?”帮助，应该接受事件</td> 
  </tr> 
  <tr> 
   <td>QEvent::ReadOnlyChange</td> 
   <td>106</td> 
   <td>部件的 read-only 状态发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::RequestSoftwareInputPanel</td> 
   <td>199</td> 
   <td>部件想要打开软件输入面板（SIP）</td> 
  </tr> 
  <tr> 
   <td>QEvent::Resize</td> 
   <td>14</td> 
   <td>部件的大小发生改变（QResizeEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ScrollPrepare</td> 
   <td>204</td> 
   <td>对象需要填充它的几何信息（QScrollPrepareEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::Scroll</td> 
   <td>205</td> 
   <td>对象需要滚动到提供的位置（QScrollEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::Shortcut</td> 
   <td>117</td> 
   <td>快捷键处理（QShortcutEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ShortcutOverride</td> 
   <td>51</td> 
   <td>按下按键，用于覆盖快捷键（QKeyEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::Show</td> 
   <td>17</td> 
   <td>部件显示在屏幕上（QShowEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ShowToParent</td> 
   <td>26</td> 
   <td>子部件被显示</td> 
  </tr> 
  <tr> 
   <td>QEvent::SockAct</td> 
   <td>50</td> 
   <td>Socket 激活，用于实现 QSocketNotifier</td> 
  </tr> 
  <tr> 
   <td>QEvent::StateMachineSignal</td> 
   <td>192</td> 
   <td>信号被传递到状态机（QStateMachine::SignalEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::StateMachineWrapped</td> 
   <td>193</td> 
   <td>事件是一个包装器，用于包含另一个事件（QStateMachine::WrappedEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::StatusTip</td> 
   <td>112</td> 
   <td>状态提示请求（QStatusTipEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::StyleChange</td> 
   <td>100</td> 
   <td>部件的样式发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::TabletMove</td> 
   <td>87</td> 
   <td>Wacom 写字板移动（QTabletEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::TabletPress</td> 
   <td>92</td> 
   <td>Wacom 写字板按下（QTabletEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::TabletRelease</td> 
   <td>93</td> 
   <td>Wacom 写字板释放（QTabletEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::OkRequest</td> 
   <td>94</td> 
   <td>Ok 按钮在装饰前被按下，仅支持 Windows CE</td> 
  </tr> 
  <tr> 
   <td>QEvent::TabletEnterProximity</td> 
   <td>171</td> 
   <td>Wacom 写字板进入接近事件（QTabletEvent），发送到 QApplication</td> 
  </tr> 
  <tr> 
   <td>QEvent::TabletLeaveProximity</td> 
   <td>172</td> 
   <td>Wacom 写字板离开接近事件（QTabletEvent），发送到 QApplication</td> 
  </tr> 
  <tr> 
   <td>QEvent::ThreadChange</td> 
   <td>22</td> 
   <td>对象被移动到另一个线程。这是发送到此对象的最后一个事件在上一个线程中，参见：QObject::moveToThread()</td> 
  </tr> 
  <tr> 
   <td>QEvent::Timer</td> 
   <td>1</td> 
   <td>定时器事件（QTimerEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ToolBarChange</td> 
   <td>120</td> 
   <td>工具栏按钮在 OS X 上进行切换</td> 
  </tr> 
  <tr> 
   <td>QEvent::ToolTip</td> 
   <td>110</td> 
   <td>一个 tooltip 请求（QHelpEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::ToolTipChange</td> 
   <td>184</td> 
   <td>部件的 tooltip 发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::TouchBegin</td> 
   <td>194</td> 
   <td>触摸屏或轨迹板事件序列的开始（QTouchEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::TouchCancel</td> 
   <td>209</td> 
   <td>取消触摸事件序列（QTouchEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::TouchEnd</td> 
   <td>196</td> 
   <td>触摸事件序列结束（QTouchEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::TouchUpdate</td> 
   <td>195</td> 
   <td>触摸屏事件（QTouchEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::UngrabKeyboard</td> 
   <td>189</td> 
   <td>Item 失去键盘抓取（QGraphicsItem）</td> 
  </tr> 
  <tr> 
   <td>QEvent::UngrabMouse</td> 
   <td>187</td> 
   <td>Item 失去鼠标抓取（QGraphicsItem、QQuickItem）</td> 
  </tr> 
  <tr> 
   <td>QEvent::UpdateLater</td> 
   <td>78</td> 
   <td>部件应该排队在以后重新绘制</td> 
  </tr> 
  <tr> 
   <td>QEvent::UpdateRequest</td> 
   <td>77</td> 
   <td>部件应该被重绘</td> 
  </tr> 
  <tr> 
   <td>QEvent::WhatsThis</td> 
   <td>111</td> 
   <td>部件应该显示“What’s This”帮助（QHelpEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::WhatsThisClicked</td> 
   <td>118</td> 
   <td>部件的“What’s This”帮助链接被点击</td> 
  </tr> 
  <tr> 
   <td>QEvent::Wheel</td> 
   <td>31</td> 
   <td>鼠标滚轮滚动（QWheelEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::WinEventAct</td> 
   <td>132</td> 
   <td>发生了 Windows 特定的激活事件</td> 
  </tr> 
  <tr> 
   <td>QEvent::WindowActivate</td> 
   <td>24</td> 
   <td>窗口已激活</td> 
  </tr> 
  <tr> 
   <td>QEvent::WindowBlocked</td> 
   <td>103</td> 
   <td>窗口被模态对话框阻塞</td> 
  </tr> 
  <tr> 
   <td>QEvent::WindowDeactivate</td> 
   <td>25</td> 
   <td>窗户被停用</td> 
  </tr> 
  <tr> 
   <td>QEvent::WindowIconChange</td> 
   <td>34</td> 
   <td>窗口的图标发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::WindowStateChange</td> 
   <td>105</td> 
   <td>窗口的状态（最小化、最大化或全屏）发生改变（QWindowStateChangeEvent）</td> 
  </tr> 
  <tr> 
   <td>QEvent::WindowTitleChange</td> 
   <td>33</td> 
   <td>窗口的标题发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::WindowUnblocked</td> 
   <td>104</td> 
   <td>一个模态对话框退出后，窗口将不被阻塞</td> 
  </tr> 
  <tr> 
   <td>QEvent::WinIdChange</td> 
   <td>203</td> 
   <td>本地窗口的系统标识符发生改变</td> 
  </tr> 
  <tr> 
   <td>QEvent::ZOrderChange</td> 
   <td>126</td> 
   <td>部件的 z 值发生了改变，该事件不会发送给顶层窗口</td> 
  </tr> 
 </tbody> 
</table>

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

<table> 
 <thead> 
  <tr> 
   <th>常量</th> 
   <th>值</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>QEvent::User</td> 
   <td>1000</td> 
   <td>用户定义的事件</td> 
  </tr> 
  <tr> 
   <td>QEvent::MaxUser</td> 
   <td>65535</td> 
   <td>最后的用户事件 ID</td> 
  </tr> 
 </tbody> 
</table>

为方便起见，可以使用 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/liang19890820/article/details/51933153

[Link 1]: http://blog.csdn.net/liang19890820/article/details/51933153#%E7%AE%80%E8%BF%B0
[Link 2]: http://blog.csdn.net/liang19890820/article/details/51933153#%E6%88%90%E5%91%98%E7%B1%BB%E5%9E%8B
[Link 3]: http://blog.csdn.net/liang19890820/article/details/51933153#%E5%B1%9E%E6%80%A7%E6%96%87%E6%A1%A3
[Link 4]: http://blog.csdn.net/liang19890820/article/details/51933153#%E6%88%90%E5%91%98%E5%87%BD%E6%95%B0%E6%96%87%E6%A1%A3