QTest Class Reference · PyQt4 中文文檔

# QTest Class Reference ## [[QtTest](index.htm) module] 該QTEST命名空間包含所有相關的功能和聲明[QTestLib](index.htm#qtestlib)工具。[More...](#details) ### Types * `enum KeyAction { Press, Release, Click }` * `enum MouseAction { MousePress, MouseRelease, MouseClick, MouseDClick, MouseMove }` ### Static Methods * `keyClick (QWidget?widget, Qt.Key?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1)` * `keyClick (QWidget?widget, str?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1)` * `keyClicks (QWidget?widget, QString?sequence, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1)` * `keyEvent (KeyAction?action, QWidget?widget, Qt.Key?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1)` * `keyEvent (KeyAction?action, QWidget?widget, str?ascii, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1)` * `keyPress (QWidget?widget, Qt.Key?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1)` * `keyPress (QWidget?widget, str?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1)` * `keyRelease (QWidget?widget, Qt.Key?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1)` * `keyRelease (QWidget?widget, str?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1)` * `mouseClick (QWidget?widget, Qt.MouseButton?button, Qt.KeyboardModifiers?modifier?=?0, QPoint?pos?=?QPoint(), int?delay?=?-1)` * `mouseDClick (QWidget?widget, Qt.MouseButton?button, Qt.KeyboardModifiers?modifier?=?0, QPoint?pos?=?QPoint(), int?delay?=?-1)` * `mouseEvent (MouseAction?action, QWidget?widget, Qt.MouseButton?button, Qt.KeyboardModifiers?stateKey, QPoint?pos, int?delay?=?-1)` * `mouseMove (QWidget?widget, QPoint?pos?=?QPoint(), int?delay?=?-1)` * `mousePress (QWidget?widget, Qt.MouseButton?button, Qt.KeyboardModifiers?modifier?=?0, QPoint?pos?=?QPoint(), int?delay?=?-1)` * `mouseRelease (QWidget?widget, Qt.MouseButton?button, Qt.KeyboardModifiers?modifier?=?0, QPoint?pos?=?QPoint(), int?delay?=?-1)` * `qSleep (int?ms)` * `qWait (int?ms)` * `bool qWaitForWindowShown (QWidget?window)` * * * ## Detailed Description 該QTEST命名空間包含所有相關的功能和聲明[QTestLib](index.htm#qtestlib)工具。請參閱[QTestLib Manual](index.htm)文檔以獲取有關如何編寫單元測試的信息。 * * * ## Type Documentation ``` QTest.KeyAction ``` 這個枚舉變量描述了密鑰處理可能的操作。 | Constant | Value | Description | | --- | --- | --- | | `QTest.Press` | `0` | 該鍵被按下。 | | `QTest.Release` | `1` | 鍵被釋放。 | | `QTest.Click` | `2` | 關鍵是點擊（按下并釋放）。 | ``` QTest.MouseAction ``` 這個枚舉變量描述了鼠標處理可能的操作。 | Constant | Value | Description | | --- | --- | --- | | `QTest.MousePress` | `0` | 鼠標按鈕被按下。 | | `QTest.MouseRelease` | `1` | 釋放鼠標按鈕。 | | `QTest.MouseClick` | `2` | 單擊鼠標按鈕（按下并釋放）。 | | `QTest.MouseDClick` | `3` | 鼠標按鈕雙擊時（按下并釋放兩次）。 | | `QTest.MouseMove` | `4` | 將鼠標指針移動。 | * * * ## Method Documentation ``` QTest.keyClick (QWidget?widget, Qt.Key?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1) ``` 模擬點擊的_key_具有可選_modifier_上一個_widget_。如果_delay_大于0 ，則測試將等待_delay_毫秒。示例： ``` [QTest](qtest.html).keyClick(myWidget, [Qt](qt.html).Key_Escape); [QTest](qtest.html).keyClick(myWidget, [Qt](qt.html).Key_Escape, [Qt](qt.html).ShiftModifier, 200); ``` 上面第一個例子模擬點擊`escape`關鍵`myWidget`沒有任何鍵盤功能鍵和無延遲。第二個例子模擬點擊`shift-escape`上`myWidget`用試驗的以下200毫秒的延遲。 **See also** [QTest.keyClicks](qtest.html#keyClicks)（）。 ``` QTest.keyClick (QWidget?widget, str?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1) ``` 這是一個重載函數。模擬點擊的_key_具有可選_modifier_上一個_widget_。如果_delay_大于0 ，則測試將等待_delay_毫秒。例如： ``` [QTest](qtest.html).keyClick(myWidget, 'a'); ``` 上面的例子中模擬點擊`a`上`myWidget`沒有任何鍵盤功能鍵和沒有測試的延遲。 **See also** [QTest.keyClicks](qtest.html#keyClicks)（）。 ``` QTest.keyClicks (QWidget?widget, QString?sequence, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1) ``` 模擬點擊一個_sequence_上一個鍵_widget_。任選地，一個鍵盤_modifier_可以被指定，以及一個_delay_（以毫秒為單位）每個鍵擊之前的測試。例如： ``` [QTest](qtest.html).keyClicks(myWidget, "hello world"); ``` 上面的例子中模擬點擊代表的“ Hello World”的鍵序列`myWidget`沒有任何鍵盤功能鍵和沒有測試的延遲。 **See also** [QTest.keyClick](qtest.html#keyClick)（）。 ``` QTest.keyEvent (KeyAction?action, QWidget?widget, Qt.Key?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1) ``` 發送一個Qt的關鍵事件_widget_用給定的_key_和一個相關的_action_。任選地，一個鍵盤_modifier_可以被指定，以及一個_delay_（以毫秒為單位）發送事件之前的測試。 ``` QTest.keyEvent (KeyAction?action, QWidget?widget, str?ascii, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1) ``` 這是一個重載函數。發送一個Qt的關鍵事件_widget_用給定的鍵_ascii_和一個相關的_action_。任選地，一個鍵盤_modifier_可以被指定，以及一個_delay_（以毫秒為單位）發送事件之前的測試。 ``` QTest.keyPress (QWidget?widget, Qt.Key?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1) ``` 模擬按下一個_key_具有可選_modifier_上一個_widget_。如果_delay_大于0 ，則測試將等待_delay_毫秒。 **Note:**在某些時候，你應該使用松開按鍵[keyRelease](qtest.html#keyRelease)（）。 **See also** [QTest.keyRelease](qtest.html#keyRelease)（）和[QTest.keyClick](qtest.html#keyClick)（）。 ``` QTest.keyPress (QWidget?widget, str?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1) ``` 這是一個重載函數。模擬按下一個_key_具有可選_modifier_上一個_widget_。如果_delay_大于0 ，則測試將等待_delay_毫秒。 **Note:**在某些時候，你應該使用松開按鍵[keyRelease](qtest.html#keyRelease)（）。 **See also** [QTest.keyRelease](qtest.html#keyRelease)（）和[QTest.keyClick](qtest.html#keyClick)（）。 ``` QTest.keyRelease (QWidget?widget, Qt.Key?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1) ``` 模擬釋放_key_具有可選_modifier_上一個_widget_。如果_delay_大于0 ，則測試將等待_delay_毫秒。 **See also** [QTest.keyPress](qtest.html#keyPress)（）和[QTest.keyClick](qtest.html#keyClick)（）。 ``` QTest.keyRelease (QWidget?widget, str?key, Qt.KeyboardModifiers?modifier?=?Qt.NoModifier, int?delay?=?-1) ``` 這是一個重載函數。模擬釋放_key_具有可選_modifier_上一個_widget_。如果_delay_大于0 ，則測試將等待_delay_毫秒。 **See also** [QTest.keyClick](qtest.html#keyClick)（）。 ``` QTest.mouseClick (QWidget?widget, Qt.MouseButton?button, Qt.KeyboardModifiers?modifier?=?0, QPoint?pos?=?QPoint(), int?delay?=?-1) ``` 模擬點擊鼠標_button_具有可選_modifier_上一個_widget_。點擊的位置被定義為_pos_，默認位置是widget的中心。如果_delay_被指定，測試將等待指定的毫秒金額前按下并釋放按鈕之前。 **See also** [QTest.mousePress](qtest.html#mousePress)（）和[QTest.mouseRelease](qtest.html#mouseRelease)（）。 ``` QTest.mouseDClick (QWidget?widget, Qt.MouseButton?button, Qt.KeyboardModifiers?modifier?=?0, QPoint?pos?=?QPoint(), int?delay?=?-1) ``` 模擬雙擊鼠標_button_具有可選_modifier_上一個_widget_。點擊的位置被定義為_pos_，默認位置是widget的中心。如果_delay_被指定，測試將等待指定的毫秒數量每次按下和釋放之前。 **See also** [QTest.mouseClick](qtest.html#mouseClick)（）。 ``` QTest.mouseEvent (MouseAction?action, QWidget?widget, Qt.MouseButton?button, Qt.KeyboardModifiers?stateKey, QPoint?pos, int?delay?=?-1) ``` ``` QTest.mouseMove (QWidget?widget, QPoint?pos?=?QPoint(), int?delay?=?-1) ``` 將鼠標指針移動到_widget_。如果_pos_沒有指定，將鼠標指針移動到窗口小部件的中心。如果_delay_（以毫秒為單位）給出，測試將移動鼠標指針前等待。 ``` QTest.mousePress (QWidget?widget, Qt.MouseButton?button, Qt.KeyboardModifiers?modifier?=?0, QPoint?pos?=?QPoint(), int?delay?=?-1) ``` 模擬按下鼠標_button_具有可選_modifier_上一個_widget_。該位置被定義為_pos_，默認位置是widget的中心。如果_delay_被指定，測試將等待指定的毫秒金額按前。 **See also** [QTest.mouseRelease](qtest.html#mouseRelease)（）和[QTest.mouseClick](qtest.html#mouseClick)（）。 ``` QTest.mouseRelease (QWidget?widget, Qt.MouseButton?button, Qt.KeyboardModifiers?modifier?=?0, QPoint?pos?=?QPoint(), int?delay?=?-1) ``` 模擬松開鼠標_button_具有可選_modifier_上一個_widget_。釋放的位置被定義為_pos_，默認位置是widget的中心。如果_delay_被指定，測試將等待指定的毫秒量釋放按鈕之前。 **See also** [QTest.mousePress](qtest.html#mousePress)（）和[QTest.mouseClick](qtest.html#mouseClick)（）。 ``` QTest.qSleep (int?ms) ``` 休眠_ms_毫秒，阻止執行的測試。 qSleep （）不會做任何事件處理，并留下您的測試反應遲鈍。網絡通信可能會超時而睡。使用[qWait](qtest.html#qWait)（）做非阻塞睡覺。 _ms_必須大于0 。 **Note:**該qSleep （）函數調用任一`nanosleep()`在UNIX或`Sleep()`上的窗口，因此時間在qSleep使用了（）的精度依賴于操作系統。例如： ``` [QTest](qtest.html).qSleep(250); ``` **See also** [qWait](qtest.html#qWait)（）。 ``` QTest.qWait (int?ms) ``` 等待_ms_毫秒。在等待時，事件將被處理，你的測試將保持響應用戶界面事件或網絡通信。例如： ``` int i = 0; while (myNetworkServerNotResponding() && i++ < 50) [QTest](qtest.html).qWait(250); ``` 上面的代碼將等待，直到網絡服務器響應最多約12.5秒。 **See also** [QTest.qSleep](qtest.html#qSleep)（）。 ``` bool QTest.qWaitForWindowShown (QWidget?window) ``` 等待，直到_window_顯示在屏幕上。這主要是異步系統，如X11 ，其中一個窗口將被映射被要求出示自己在屏幕上后，屏幕一段時間非常有用。返回True。例如： ``` [QWidget](qwidget.html) widget; widget.show(); [QTest](qtest.html).qWaitForWindowShown(&widget); ``` 此功能被引入Qt的4.6 。