QMouseEvent Class Reference · PyQt4 中文文檔

# QMouseEvent Class Reference ## [[QtGui](index.htm) module] 該QMouseEvent類包含描述一個鼠標事件參數。[More...](#details) 繼承[QInputEvent](qinputevent.html)。 ### Methods * `__init__ (self, QEvent.Type?type, QPoint?pos, Qt.MouseButton?button, Qt.MouseButtons?buttons, Qt.KeyboardModifiers?modifiers)` * `__init__ (self, QEvent.Type?type, QPoint?pos, QPoint?globalPos, Qt.MouseButton?button, Qt.MouseButtons?buttons, Qt.KeyboardModifiers?modifiers)` * `__init__ (self, QMouseEvent)` * `Qt.MouseButton button (self)` * `Qt.MouseButtons buttons (self)` * `QPoint globalPos (self)` * `int globalX (self)` * `int globalY (self)` * `bool hasExtendedInfo (self)` * `QPoint pos (self)` * `QPointF posF (self)` * `int x (self)` * `int y (self)` * * * ## Detailed Description 該QMouseEvent類包含描述一個鼠標事件參數。被按下時，一個鼠標按鈕或窗口小部件內釋放，或當鼠標光標移動的鼠標事件發生。只有當鼠標按鈕被按下時，除非鼠標跟蹤已啟用將發生的鼠標移動事件[QWidget.setMouseTracking](qwidget.html#mouseTracking-prop)（）。 Qt的自動獲取當鼠標按鈕被一個widget里面按下鼠標，小工具將繼續接收鼠標事件，直到最后釋放鼠標按鈕。鼠標事件包含一個特殊的接受標志，指示接收者是否愿意事件。你應該調用[ignore](qevent.html#ignore)（）如果鼠標事件不是由您的Widget處理。鼠標事件被傳播到父控件鏈，直到一個小部件接受它[accept](qevent.html#accept)（），或者一個事件過濾器會消耗它。 **Note:**如果鼠標事件被傳播到[widget](qwidget.html)對于這[Qt.WA_NoMousePropagation](qt.html#WidgetAttribute-enum)已定，即鼠標事件將不會被進一步傳播到父控件鏈。鍵盤修飾鍵的狀態，可以通過調用被發現[modifiers()](qinputevent.html#modifiers)功能，從繼承[QInputEvent](qinputevent.html)。該功能[pos](qmouseevent.html#pos)（）[x](qmouseevent.html#x)（）和[y](qmouseevent.html#y)相對的（）給光標所在位置到該接收鼠標事件的小部件。如果移動部件作為鼠標事件的結果，請使用返回的全球地位[globalPos](qmouseevent.html#globalPos)（）避免震動運動。該[QWidget.setEnabled](qwidget.html#enabled-prop)（）函數可以被用來使能或禁止鼠標和鍵盤事件為一個部件。重新實現[QWidget](qwidget.html)事件處理程序，[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（）[QWidget.mouseReleaseEvent](qwidget.html#mouseReleaseEvent)（）[QWidget.mouseDoubleClickEvent](qwidget.html#mouseDoubleClickEvent)（）和[QWidget.mouseMoveEvent](qwidget.html#mouseMoveEvent)（）來接收自己的小部件的鼠標事件。 * * * ## Method Documentation ``` QMouseEvent.__init__ (self, QEvent.Type?type, QPoint?pos, Qt.MouseButton?button, Qt.MouseButtons?buttons, Qt.KeyboardModifiers?modifiers) ``` 構造一個鼠標事件的對象。該_type_參數必須是一個[QEvent.MouseButtonPress](qevent.html#Type-enum)，[QEvent.MouseButtonRelease](qevent.html#Type-enum)，[QEvent.MouseButtonDblClick](qevent.html#Type-enum)或[QEvent.MouseMove](qevent.html#Type-enum)。該_position_是鼠標光標的位置相對于接收部件。該_button_導致事件被給定為從一個值[Qt.MouseButton](qt.html#MouseButton-enum)枚舉。如果該事件_type_ is [MouseMove](qevent.html#Type-enum)，對于此事件的相應按鈕[Qt.NoButton](qt.html#MouseButton-enum)。鼠標和鍵盤狀態在事件發生時被指定_buttons_和_modifiers_。該[globalPos](qmouseevent.html#globalPos)（）被初始化為[QCursor.pos](qcursor.html#pos)（），這可能不適合。使用其他構造函數來顯式地指定的國際地位。 ``` QMouseEvent.__init__ (self, QEvent.Type?type, QPoint?pos, QPoint?globalPos, Qt.MouseButton?button, Qt.MouseButtons?buttons, Qt.KeyboardModifiers?modifiers) ``` 構造一個鼠標事件的對象。該_type_參數必須是[QEvent.MouseButtonPress](qevent.html#Type-enum)，[QEvent.MouseButtonRelease](qevent.html#Type-enum)，[QEvent.MouseButtonDblClick](qevent.html#Type-enum)或[QEvent.MouseMove](qevent.html#Type-enum)。該_pos_是鼠標光標的位置相對于接收部件。在全局坐標光標的位置由指定的_globalPos_。該_button_導致事件被給定為從一個值[Qt.MouseButton](qt.html#MouseButton-enum)枚舉。如果該事件_type_ is [MouseMove](qevent.html#Type-enum)，對于此事件的相應按鈕[Qt.NoButton](qt.html#MouseButton-enum)。_buttons_是在事件發生時所有按鍵的狀態，_modifiers_所有鍵盤功能鍵的狀態。 ``` QMouseEvent.__init__ (self, QMouseEvent) ``` ``` Qt.MouseButton QMouseEvent.button (self) ``` [ 返回引發事件的按鈕。 ](qt.html#MouseButton-enum) [注意，返回的值總是](qt.html#MouseButton-enum)[Qt.NoButton](qt.html#MouseButton-enum)對于鼠標移動事件。 **See also** [buttons](qmouseevent.html#buttons)（）和[Qt.MouseButton](qt.html#MouseButton-enum)。 ``` Qt.MouseButtons QMouseEvent.buttons (self) ``` [](index.htm) [返回生成事件時，該按鈕的狀態。按鈕狀態是組合](index.htm)[Qt.LeftButton](qt.html#MouseButton-enum)，[Qt.RightButton](qt.html#MouseButton-enum)，[Qt.MidButton](qt.html#MouseButton-enum)使用OR運算符。對于鼠標移動事件，這是按下所有按鈕。對于鼠標按下，然后雙擊事件，這包括引發事件的按鈕。對于鼠標釋放事件這不包括引發事件的按鈕。 **See also** [button](qmouseevent.html#button)（）和[Qt.MouseButton](qt.html#MouseButton-enum)。 ``` QPoint QMouseEvent.globalPos (self) ``` [](qpoint.html) [返回鼠標光標的全球地位_at the time of the event_。這是很重要的異步窗口系統，例如X11 。每當你在響應鼠標事件四處移動你的部件， globalPos （）可以從當前指針位置不同，很多](qpoint.html)[QCursor.pos](qcursor.html#pos)（），并從QWidget.mapToGlobal （[pos](qmouseevent.html#pos)（））。 **See also** [globalX](qmouseevent.html#globalX)（）和[globalY](qmouseevent.html#globalY)（）。 ``` int QMouseEvent.globalX (self) ``` 返回在事件發生時鼠標光標的全局x位置。 **See also** [globalY](qmouseevent.html#globalY)（）和[globalPos](qmouseevent.html#globalPos)（）。 ``` int QMouseEvent.globalY (self) ``` 返回在事件發生時鼠標光標的全球y位置。 **See also** [globalX](qmouseevent.html#globalX)（）和[globalPos](qmouseevent.html#globalPos)（）。 ``` bool QMouseEvent.hasExtendedInfo (self) ``` ``` QPoint QMouseEvent.pos (self) ``` [ 返回鼠標光標的位置，相對于接收到的事件的插件。 ](qpoint.html) [如果移動部件作為鼠標事件的結果，請使用返回的全球地位](qpoint.html)[globalPos](qmouseevent.html#globalPos)（）避免震動運動。 **See also** [x](qmouseevent.html#x)（）[y](qmouseevent.html#y)（）和[globalPos](qmouseevent.html#globalPos)（）。 ``` QPointF QMouseEvent.posF (self) ``` [](qpointf.html) [返回的鼠標光標的位置](qpointf.html)[QPointF](qpointf.html)，相對于接收到的事件的插件。如果移動部件作為鼠標事件的結果，請使用返回的全球地位[globalPos](qmouseevent.html#globalPos)（）避免震動運動。此功能被引入Qt的4.4 。 **See also** [x](qmouseevent.html#x)（）[y](qmouseevent.html#y)（）[pos](qmouseevent.html#pos)（）和[globalPos](qmouseevent.html#globalPos)（）。 ``` int QMouseEvent.x (self) ``` 返回鼠標光標的x位置，相對于接收到的事件的插件。 **See also** [y](qmouseevent.html#y)（）和[pos](qmouseevent.html#pos)（）。 ``` int QMouseEvent.y (self) ``` 返回鼠標光標的y位置，相對于接收事件的窗口小部件。 **See also** [x](qmouseevent.html#x)（）和[pos](qmouseevent.html#pos)（）。