QTabletEvent Class Reference · PyQt4 中文文檔

# QTabletEvent Class Reference ## [[QtGui](index.htm) module] 該QTabletEvent類包含描述一個平板事件參數。[More...](#details) 繼承[QInputEvent](qinputevent.html)。 ### Types * `enum PointerType { UnknownPointer, Pen, Cursor, Eraser }` * `enum TabletDevice { NoDevice, Puck, Stylus, Airbrush, ..., RotationStylus }` ### Methods * `__init__ (self, QEvent.Type?t, QPoint?pos, QPoint?globalPos, QPointF?hiResGlobalPos, int?device, int?pointerType, float?pressure, int?xTilt, int?yTilt, float?tangentialPressure, float?rotation, int?z, Qt.KeyboardModifiers?keyState, int?uniqueID)` * `__init__ (self, QTabletEvent)` * `TabletDevice device (self)` * `QPoint globalPos (self)` * `int globalX (self)` * `int globalY (self)` * `QPointF hiResGlobalPos (self)` * `float hiResGlobalX (self)` * `float hiResGlobalY (self)` * `PointerType pointerType (self)` * `QPoint pos (self)` * `float pressure (self)` * `float rotation (self)` * `float tangentialPressure (self)` * `int uniqueId (self)` * `int x (self)` * `int xTilt (self)` * `int y (self)` * `int yTilt (self)` * `int z (self)` * * * ## Detailed Description 該QTabletEvent類包含描述一個平板事件參數。從Wacom數位板產生片劑活動。大多數時候，你會想應對來自平板電腦的事件，好像他們是從一個鼠標事件，例如，您可以檢索與光標位置[x](qtabletevent.html#x)（）[y](qtabletevent.html#y)（）[pos](qtabletevent.html#pos)（）[globalX](qtabletevent.html#globalX)（）[globalY](qtabletevent.html#globalY)（）和[globalPos](qtabletevent.html#globalPos)（）。在某些情況下，您可能希望獲取平板電腦設備驅動程序提供了額外的信息，例如，您可能想要做更高分辨率的坐標subpixeling或者您可能希望根據壓力來調整色彩亮度。 QTabletEvent讓您閱讀[pressure](qtabletevent.html#pressure)（）中的[xTilt](qtabletevent.html#xTilt)（）和[yTilt](qtabletevent.html#yTilt)（），以及設備的類型與用來[device](qtabletevent.html#device)（）（見[TabletDevice](qtabletevent.html#TabletDevice-enum)）。它也可以給你的最低和最高值的每個設備的壓力和高分辨率的坐標。片劑事件中包含一個特殊的接受標志，指示接收者是否愿意事件。你應該調用[QTabletEvent.accept](qevent.html#accept)（）如果你處理的平板事件，否則將被發送到父widget 。唯一的例外是[TabletEnterProximity](qevent.html#Type-enum)和[TabletLeaveProximity](qevent.html#Type-enum)事件，這些只發送到[QApplication](qapplication.html)不檢查是否它們是否接受。該[QWidget.setEnabled](qwidget.html#enabled-prop)（）函數可以被用來使能或禁止鼠標和鍵盤事件為一個部件。該事件處理程序[QWidget.tabletEvent](qwidget.html#tabletEvent)（）接收所有三種類型的平板電腦的事件。 Qt會首先發一個tabletEvent那么，如果不被接受，它會發送一個鼠標事件。這允許不使用平板電腦應用程序使用平板電腦就像一個鼠標，同時也使那些誰想要同時使用平板電腦和鼠標不同。 ### Notes for X11 Users Qt使用下面的硬編碼名稱來自于X11的xorg.conf文件（除了IRIX ）確定平板設備： “手寫筆”，“鋼筆”和“橡皮擦” 。如果設備有其他的名字，他們將不會被拾起的Qt 。 * * * ## Type Documentation ``` QTabletEvent.PointerType ``` 這個枚舉變量定義什么類型的點生成事件。 | Constant | Value | Description | | --- | --- | --- | | `QTabletEvent.UnknownPointer` | `0` | 一個未知設備。 | | `QTabletEvent.Pen` | `1` | 手寫筆的設備（筆的窄端）的末端。 | | `QTabletEvent.Cursor` | `2` | 任何冰球之類的設備。 | | `QTabletEvent.Eraser` | `3` | 手寫筆的設備（筆的寬端）的橡皮擦端。 | **See also** [pointerType](qtabletevent.html#pointerType)（）。 ``` QTabletEvent.TabletDevice ``` 這個枚舉變量定義什么類型的設備正在生成事件。 | Constant | Value | Description | | --- | --- | --- | | `QTabletEvent.NoDevice` | `0` | 沒有設備或未知設備。 | | `QTabletEvent.Puck` | `1` | 冰球（一種裝置，類似于一個扁平鼠標采用了透明的圓十字線）。 | | `QTabletEvent.Stylus` | `2` | 手寫筆。 | | `QTabletEvent.Airbrush` | `3` | 噴槍 | | `QTabletEvent.FourDMouse` | `4` | 一個4D鼠標。 | | `QTabletEvent.RotationStylus` | `6` | 一個特殊的手寫筆也知道旋轉（一6D手寫筆）。 | 這個枚舉被引入或修改的Qt 4.1 。 * * * ## Method Documentation ``` QTabletEvent.__init__ (self, QEvent.Type?t, QPoint?pos, QPoint?globalPos, QPointF?hiResGlobalPos, int?device, int?pointerType, float?pressure, int?xTilt, int?yTilt, float?tangentialPressure, float?rotation, int?z, Qt.KeyboardModifiers?keyState, int?uniqueID) ``` 構造的給定片劑事件_type_。該_pos_參數表示凡在插件的事件發生;_globalPos_是在絕對坐標中的相應位置。該_hiResGlobalPos_包含的位置的高分辨率測量。 _pressure_包含施加在壓力_device_。 _pointerType_描述正在使用的筆的類型。 _xTilt_和_yTilt_分別包含在x和y軸傾斜設備的程度。 _keyState_其鍵盤功能鍵被按下指定（如，**Ctrl**）。該_uniqueID_參數包含當前設備的唯一ID 。該_z_參數包含在平板設備的坐標，這通常是由在4D鼠標滾輪給出。如果設備不支持Z軸，傳遞零這里。該_tangentialPressure_參數contins氣刷的切線壓力。如果設備不支持切向壓力，傳遞0在這里。 _rotation_包含度裝置的旋轉。 4D鼠標支持旋轉。如果設備不支持旋轉，傳遞0在這里。 **See also** [pos](qtabletevent.html#pos)（）[globalPos](qtabletevent.html#globalPos)（）[device](qtabletevent.html#device)（）[pressure](qtabletevent.html#pressure)（）[xTilt](qtabletevent.html#xTilt)（）[yTilt](qtabletevent.html#yTilt)（）[uniqueId](qtabletevent.html#uniqueId)（）[rotation](qtabletevent.html#rotation)（）[tangentialPressure](qtabletevent.html#tangentialPressure)（）和[z](qtabletevent.html#z)（）。 ``` QTabletEvent.__init__ (self, QTabletEvent) ``` ``` TabletDevice QTabletEvent.device (self) ``` [ 返回裝置產生事件的類型。 ](qtabletevent.html#TabletDevice-enum) [**See also**](qtabletevent.html#TabletDevice-enum) [TabletDevice](qtabletevent.html#TabletDevice-enum)。 ``` QPoint QTabletEvent.globalPos (self) ``` [](qpoint.html) [返回設備的全球地位_at the time of the event_。這是很重要的異步Windows系統上的X11一樣，每當你在響應鼠標事件， globalPos左右移動你的widget （）可以顯著從當前位置有所不同](qpoint.html)[QCursor.pos](qcursor.html#pos)（）。 **See also** [globalX](qtabletevent.html#globalX)（）[globalY](qtabletevent.html#globalY)（）和[hiResGlobalPos](qtabletevent.html#hiResGlobalPos)（）。 ``` int QTabletEvent.globalX (self) ``` 返回在事件發生時鼠標指針的全局x位置。 **See also** [globalY](qtabletevent.html#globalY)（）[globalPos](qtabletevent.html#globalPos)（）和[hiResGlobalX](qtabletevent.html#hiResGlobalX)（）。 ``` int QTabletEvent.globalY (self) ``` 返回在事件發生時的平板設備的全球y位置。 **See also** [globalX](qtabletevent.html#globalX)（）[globalPos](qtabletevent.html#globalPos)（）和[hiResGlobalY](qtabletevent.html#hiResGlobalY)（）。 ``` QPointF QTabletEvent.hiResGlobalPos (self) ``` [](qpointf.html) [從平板電腦傳送的高精度坐標表示。子pixeling信息是在的小數部分](qpointf.html)[QPointF](qpointf.html)。 **See also** [globalPos](qtabletevent.html#globalPos)（）[hiResGlobalX](qtabletevent.html#hiResGlobalX)（）和[hiResGlobalY](qtabletevent.html#hiResGlobalY)（）。 ``` float QTabletEvent.hiResGlobalX (self) ``` 平板設備的精度高x位置。 ``` float QTabletEvent.hiResGlobalY (self) ``` 平板設備的高精度y位置。 ``` PointerType QTabletEvent.pointerType (self) ``` [ 返回點生成事件的類型。 ](qtabletevent.html#PointerType-enum) ``` QPoint QTabletEvent.pos (self) ``` [ 返回該裝置的位置，相對于接收到的事件的插件。 ](qpoint.html) [如果您在響應鼠標事件，利用左右移動部件](qpoint.html)[globalPos](qtabletevent.html#globalPos)（代替此功能）。 **See also** [x](qtabletevent.html#x)（）[y](qtabletevent.html#y)（）和[globalPos](qtabletevent.html#globalPos)（）。 ``` float QTabletEvent.pressure (self) ``` 返回該設備的壓力。 0.0表示該指示筆是不是就片劑， 1.0表示為觸針的壓力的最大量。 **See also** [tangentialPressure](qtabletevent.html#tangentialPressure)（）。 ``` float QTabletEvent.rotation (self) ``` 返回學位的當前設備的旋轉。這通常是通過一個4D鼠標給出。如果設備不支持旋轉此值始終為0.0 。 ``` float QTabletEvent.tangentialPressure (self) ``` 返回該設備的切線壓力。這通常是通過對噴槍工具手指輪給出。范圍是1.0到1.0 。 0.0表示一個中立的立場。當前噴槍只能移動在從量中立型位置的正方向。如果設備不支持切線壓力，此值始終為0.0 。 **See also** [pressure](qtabletevent.html#pressure)（）。 ``` int QTabletEvent.uniqueId (self) ``` 返回一個唯一的ID為當前設備，使得有可能被使用的同時在數位板上的多個設備之間的區分。支持此功能的是依賴于平板電腦。值相同的設備可能會有所不同從操作系統到操作系統。 Wacom驅動程式適用于Linux的更高版本現在將報告的ID信息。如果你有一個支持唯一ID的平板電腦，并沒有得到在Linux上的信息，請考慮升級您的驅動程序。由于Qt 4.2中，獨特的ID是一樣的，不管筆的方向。早期版本會使用橡皮擦端與某些操作系統的手寫筆的筆結束的時候報告一個不同的值。 **See also** [pointerType](qtabletevent.html#pointerType)（）。 ``` int QTabletEvent.x (self) ``` 返回設備的x位置，相對于接收到的事件的插件。 **See also** [y](qtabletevent.html#y)（）和[pos](qtabletevent.html#pos)（）。 ``` int QTabletEvent.xTilt (self) ``` 返回的x軸的方向上的垂直器件之間的角度（一個筆，例如）和。正值是對平板電腦的實際權利。該角度的范圍為-60 ?+60度。 ![](https://img.kancloud.cn/41/bb/41bbc2096915960b698b011d2b38f3ad_266x225.png) **See also** [yTilt](qtabletevent.html#yTilt)（）。 ``` int QTabletEvent.y (self) ``` 返回設備的y位置，相對于接收事件的窗口小部件。 **See also** [x](qtabletevent.html#x)（）和[pos](qtabletevent.html#pos)（）。 ``` int QTabletEvent.yTilt (self) ``` 返回在y軸方向上的垂直器件之間的角度（一個筆，例如）和。正值是對平板電腦的底部。的角度為范圍-60到+60度的范圍內。 **See also** [xTilt](qtabletevent.html#xTilt)（）。 ``` int QTabletEvent.z (self) ``` 返回設備的z位置。通常，這是通過在一個4D鼠標滾輪來表示。如果設備不支持Z軸，這個值永遠是零。這是**not**相同的壓力。 **See also** [pressure](qtabletevent.html#pressure)（）。