QTest Namespace

함수 문서

template <typename T> void QTest::addColumn(const char *name, T *dummy = 0)

현재 테스트 데이터에 T 유형의 열을 추가합니다. name 은 열의 이름입니다. dummy 은 버그가 있는 컴파일러를 위한 해결 방법이며 무시할 수 있습니다.

열을 값으로 채우려면 newRow()를 사용할 수 있습니다. 실제 테스트에서 데이터를 가져오려면 QFETCH()를 사용합니다.

예시:

    QTest::addColumn<int>("intval");
    QTest::addColumn<QString>("str");
    QTest::addColumn<double>("dbl");
    QTest::newRow("row1") << 1 << "hello" << 1.5;

더 자세한 예는 데이터 기반 테스트를 참조하세요.

QTest::newRow(), QFETCH() 및 QMetaType 를참조하세요 .

QTestData &QTest::addRow(const char *format, ...)

현재 테스트 데이터에 새 행을 추가합니다.

함수의 인수는 format 에 따라 서식을 지정하기 위해 std::snprintf()로 전달됩니다. 주의 사항 및 제한 사항은 std::snprintf() 설명서를 참조하세요.

테스트 출력은 이 포맷의 결과 이름을 사용하여 이 테스트 데이터로 실행된 테스트를 식별합니다.

테이블의 각 열에 대해 하나의 값씩 데이터를 스트리밍하는 데 사용할 수 있는 QTestData 참조를 반환합니다.

예시:

    QTest::addColumn<int>("input");
    QTest::addColumn<QString>("output");
    QTest::addRow("%d", 0) << 0 << QString("0");
    QTest::addRow("%d", 1) << 1 << QString("1");

더 자세한 예는 데이터 기반 테스트를 참조하세요.

newRow(), addColumn() 및 QFETCH()도 참조하세요 .

const char *QTest::benchmarkMetricName(QTest::QBenchmarkMetric metric)

열거형 값 metric 을 문자열로 반환합니다.

const char *QTest::benchmarkMetricUnit(QTest::QBenchmarkMetric metric)

지정된 metric 에 대한 측정 단위를 반환합니다.

QPointingDevice *QTest::createTouchDevice(QInputDevice::DeviceType devType = QInputDevice::DeviceType::TouchScreen, QInputDevice::Capabilities caps = QInputDevice::Capability::Position)

터치 이벤트 시뮬레이션을 위해 caps 기능을 갖춘 devType 유형의 더미 터치 디바이스를 만듭니다.

이 터치 디바이스는 Qt 윈도우 시스템 인터페이스에 등록됩니다. 일반적으로 createTouchDevice()를 사용하여 테스트 케이스 클래스에서 QPointingDevice 멤버 변수를 초기화하고 모든 테스트에 동일한 인스턴스를 사용하며 더 이상 필요하지 않은 경우 삭제해야 합니다.

QTest::QTouchEventSequence 및 touchEvent()도 참조하세요 .

const char *QTest::currentAppName()

현재 실행 중인 바이너리의 이름을 반환합니다.

const char *QTest::currentDataTag()

현재 테스트 데이터의 이름을 반환합니다. 테스트에 할당된 테스트 데이터가 없는 경우 이 함수는 nullptr 을 반환합니다.

bool QTest::currentTestFailed()

현재 테스트 함수가 실패하면 true, 그렇지 않으면 false를 반환합니다.

QTest::currentTestResolved()도 참조하세요 .

const char *QTest::currentTestFunction()

현재 실행 중인 테스트 함수의 이름을 반환합니다.

예제:

void MyTestClass::cleanup()
{
    if (qstrcmp(QTest::currentTestFunction(), "myDatabaseTest") == 0) {
        // clean up all database connections
        closeAllDatabases();
    }
}

[since 6.5] bool QTest::currentTestResolved()

현재 테스트 함수가 실패했거나 건너뛴 경우 true 을 반환합니다.

테스트가 실패했거나 건너뛰기를 실행한 경우에 적용됩니다. 참이면 테스트 함수가 일찍 반환되어야 합니다. 특히 QTRY_* 매크로와 테스트 이벤트 루프는 테스트 함수 중에 실행되는 경우 루프를 일찍 종료합니다(단, cleanup() 함수는 제외). 테스트가 이 모듈의 매크로를 사용하는 헬퍼 함수를 호출한 후 이 함수를 사용하여 조기 반환 여부를 테스트할 수 있습니다.

이 함수는 Qt 6.5에 도입되었습니다.

QTest::currentTestFailed()도 참조하십시오 .

[since 6.3] void QTest::failOnWarning(const QRegularExpression &messagePattern)

messagePattern 과 일치하는 각 경고에 대해 테스트 로그에 테스트 실패를 추가합니다.

실패가 추가되면 테스트 함수는 계속 실행됩니다. 대신 테스트를 중단하려면 currentTestFailed()를 확인하고 true 에 해당하는 경우 일찍 반환할 수 있습니다.

각 경고에 대해 일치하는 첫 번째 패턴은 실패를 유발하고 나머지 패턴은 무시됩니다.

모든 패턴은 각 테스트 함수가 끝날 때 지워집니다.

void FileTest::loadFiles() { QTest::failOnWarning(QRegularExpression("^로드에 실패했습니다")); // 각각 테스트 실패를 유발합니다:    qWarning() << "Failed to load image";
    qWarning() << "Failed to load video";
}

주어진 경고를 트리거하는 모든 테스트를 실패시키려면 이 함수에 적절한 정규식을 init()에 전달하세요:

void FileTest::init()
{
    QTest::failOnWarning(
        QRegularExpression("QFile::.*: File(.*) already open"));
}

모든 경고에서 실패하는 일반적인 경우에는 매개변수를 전달하지 않습니다:

void FileTest::init()
{
    QTest::failOnWarning();
}

이 함수는 Qt 6.3에 도입되었습니다.

QTEST_FATAL_FAIL도참조하십시오 .

[since 6.8] void QTest::failOnWarning()

이 함수는 failOnWarning()을 오버로드합니다.

경고가 출력되면 테스트 로그에 테스트 실패를 추가합니다.

이 함수는 Qt 6.8에 도입되었습니다.

failOnWarning()도 참조하십시오 .

[since 6.3] void QTest::failOnWarning(const char *message)

이 함수는 failOnWarning()을 오버로드합니다.

message 가 출력되면 테스트 로그에 테스트 실패를 추가합니다.

이 함수는 Qt 6.3에 도입되었습니다.

failOnWarning()도 참조하십시오 .

void QTest::ignoreMessage(QtMsgType type, const char *message)

qDebug(), qInfo() 또는 qWarning()에서 생성된 메시지는 무시합니다. 해당 type 이 포함된 message 이 출력되면 테스트 로그에서 제거됩니다. 테스트가 완료되었지만 message 이 출력되지 않으면 테스트 로그에 테스트 실패가 추가됩니다.

예시:

QDir dir;
QTest::ignoreMessage(QtWarningMsg, "QDir::mkdir: Empty or null file name(s)");
dir.mkdir("");

위의 예에서는 QDir::mkdir()가 잘못된 파일 이름으로 호출될 때 올바른 경고를 출력하는지 테스트합니다.

void QTest::ignoreMessage(QtMsgType type, const QRegularExpression &messagePattern)

이 함수는 과부하된 함수입니다.

qDebug(), qInfo() 또는 qWarning()에서 만든 메시지는 무시합니다. messagePattern 에 해당하는 type 과 일치하는 메시지가 출력되면 테스트 로그에서 제거됩니다. 테스트가 완료되었지만 메시지가 출력되지 않으면 테스트 로그에 테스트 실패가 추가됩니다.

void QTest::keyClick(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

widget 에서 선택 사항인 modifier 을 사용하여 key 클릭을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 키를 클릭하기 전에 delay 밀리초 동안 기다립니다.

예제:

QTest::keyClick(myWidget, Qt::Key_Escape);

QTest::keyClick(myWidget, Qt::Key_Escape, Qt::ShiftModifier, 200);

위의 첫 번째 예는 myWidget 에서 키보드 수정자 없이 지연 없이 escape 키를 클릭하는 것을 시뮬레이션합니다. 두 번째 예는 테스트가 200밀리초 지연된 후 myWidget 에서 shift-escape 을 클릭하는 것을 시뮬레이션합니다.

QTest::keyClicks()도 참조하세요 .

void QTest::keyClick(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이 함수는 오버로드된 함수입니다.

widget 에서 선택 사항인 modifier 을 사용하여 key 클릭을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 키를 클릭하기 전에 delay 밀리초 동안 기다립니다.

예시:

QTest::keyClick(myWidget, 'a');

위의 예는 키보드 수정자 없이 테스트 지연 없이 myWidget 에서 a 클릭을 시뮬레이션합니다.

QTest::keyClicks()도 참조하세요 .

void QTest::keyClick(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이 함수는 오버로드된 함수입니다.

window 에서 선택 사항인 modifier 을 사용하여 key 클릭을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 키를 클릭하기 전에 delay 밀리초 동안 기다립니다.

예시:

QTest::keyClick(&myWindow, Qt::Key_Escape);
QTest::keyClick(&myWindow, Qt::Key_Escape, Qt::ShiftModifier, 200);

위의 첫 번째 예는 myWindow 에서 키보드 수정자 없이 지연 없이 escape 키를 클릭하는 것을 시뮬레이션합니다. 두 번째 예는 테스트가 200밀리초 지연된 후 myWindow 에서 shift-escape 을 클릭하는 것을 시뮬레이션합니다.

QTest::keyClicks()도 참조하세요 .

void QTest::keyClick(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이 함수는 오버로드된 함수입니다.

window 에서 선택 사항인 modifier 을 사용하여 key 클릭을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 키를 클릭하기 전에 delay 밀리초 동안 기다립니다.

예시:

QWidget myWindow;
QTest::keyClick(&myWindow, Qt::Key_Tab);

위의 예는 키보드 수정자 없이 테스트 지연 없이 myWindow 에서 a 클릭을 시뮬레이션합니다.

QTest::keyClicks()도 참조하세요 .

void QTest::keyClicks(QWidget *widget, const QString &sequence, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

widget 에서 sequence 키를 클릭하는 것을 시뮬레이션합니다. 선택적으로 키보드 modifier 와 각 키 클릭 전 테스트 시간 delay (밀리초 단위)를 지정할 수 있습니다.

예시:

QTest::keyClicks(myWidget, "hello world");

위의 예는 키보드 수정자없이 테스트 지연 없이 myWidget 에서 "헬로 월드"를 나타내는 일련의 키를 클릭하는 것을 시뮬레이션합니다.

QTest::keyClick()도 참조하세요 .

void QTest::keyEvent(QTest::KeyAction action, QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

주어진 key 과 연관된 action 과 함께 Qt 키 이벤트를 widget 로 보냅니다. 선택적으로, 이벤트를 보내기 전에 modifier 키보드와 delay (밀리초 단위)의 테스트를 지정할 수 있습니다.

void QTest::keyEvent(QTest::KeyAction action, QWidget *widget, char ascii, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이것은 오버로드된 함수입니다.

지정된 키 ascii 와 연관된 action 를 사용하여 widget 로 Qt 키 이벤트를 보냅니다. 선택적으로, 이벤트를 보내기 전에 delay (밀리초 단위)의 테스트와 함께 modifier 키보드를 지정할 수 있습니다.

void QTest::keyEvent(QTest::KeyAction action, QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이것은 오버로드된 함수입니다.

주어진 key 과 연관된 action 과 함께 Qt 키 이벤트를 window 로 보냅니다. 선택적으로, 이벤트를 보내기 전에 delay (밀리초 단위)의 테스트와 함께 modifier 키보드를 지정할 수 있습니다.

void QTest::keyEvent(QTest::KeyAction action, QWindow *window, char ascii, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이것은 오버로드된 함수입니다.

지정된 키 ascii 와 연결된 action 를 사용하여 Qt 키 이벤트를 window 로 보냅니다. 선택적으로, 이벤트를 보내기 전에 delay (밀리초 단위)의 테스트와 함께 modifier 키보드를 지정할 수 있습니다.

void QTest::keyPress(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

widget 에서 선택 사항인 modifier 을 사용하여 key 을 누르는 것을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 키를 누르기 전에 delay 밀리초 동안 기다립니다.

QTest::keyRelease() 및 QTest::keyClick()도 참조하세요 .

void QTest::keyPress(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이 함수는 오버로드된 함수입니다.

widget 에서 선택 사항인 modifier 을 사용하여 key 을 누르는 것을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 키를 누르기 전에 delay 밀리초 동안 기다립니다.

QTest::keyRelease() 및 QTest::keyClick()도 참조하세요 .

void QTest::keyPress(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이 함수는 오버로드된 함수입니다.

window 에서 선택 사항인 modifier 을 사용하여 key 을 누르는 것을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 키를 누르기 전에 delay 밀리초 동안 기다립니다.

QTest::keyRelease() 및 QTest::keyClick()도 참조하세요 .

void QTest::keyPress(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이 함수는 오버로드된 함수입니다.

window 에서 선택 사항인 modifier 을 사용하여 key 을 누르는 것을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 키를 누르기 전에 delay 밀리초 동안 기다립니다.

QTest::keyRelease() 및 QTest::keyClick()도 참조하세요 .

void QTest::keyRelease(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

widget 에서 선택 사항인 modifier 을 사용하여 key 을 릴리스하는 것을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 키를 릴리스하기 전에 delay 밀리초 동안 기다립니다.

QTest::keyPress() 및 QTest::keyClick()도 참조하세요 .

void QTest::keyRelease(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이 함수는 오버로드된 함수입니다.

widget 에서 선택 사항인 modifier 을 사용하여 key 을 릴리스하는 것을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 delay 밀리초 동안 기다렸다가 키를 릴리스합니다.

QTest::keyClick()도 참조하세요 .

void QTest::keyRelease(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이 함수는 오버로드된 함수입니다.

window 에서 선택 사항인 modifier 을 사용하여 key 을 릴리스하는 것을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 delay 밀리초 동안 기다렸다가 키를 릴리스합니다.

QTest::keyPress() 및 QTest::keyClick()도 참조하세요 .

void QTest::keyRelease(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

이 함수는 오버로드된 함수입니다.

window 에서 선택 사항인 modifier 을 사용하여 key 을 릴리스하는 것을 시뮬레이션합니다. delay 이 0보다 크면 테스트는 delay 밀리초 동안 기다렸다가 키를 릴리스합니다.

QTest::keyClick()도 참조하세요 .

void QTest::keySequence(QWidget *widget, const QKeySequence &keySequence)

이 함수는 오버로드된 함수입니다.

widget 에 keySequence 를 입력하는 것을 시뮬레이션합니다.

QTest::keyClick() 및 QTest::keyClicks()도 참조하세요 .

void QTest::keySequence(QWindow *window, const QKeySequence &keySequence)

이 함수는 오버로드된 함수입니다.

window 에 keySequence 를 입력하는 것을 시뮬레이션합니다.

QTest::keyClick() 및 QTest::keyClicks()도 참조하세요 .

void QTest::mouseClick(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

widget 에서 선택 사항인 modifier 을 사용하여 마우스 button 를 클릭하는 것을 시뮬레이션합니다. 클릭 위치는 pos 으로 정의되며 기본 위치는 위젯의 중앙입니다. delay 을 지정하면 테스트는 버튼을 누르기 전과 버튼을 놓기 전에 지정된 시간(밀리초) 동안 대기합니다.

QTest::mousePress() 및 QTest::mouseRelease()도 참조하세요 .

void QTest::mouseClick(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

이 함수는 오버로드된 함수입니다.

window 에서 선택적 stateKey 수정자를 사용하여 마우스 button 를 클릭하는 것을 시뮬레이션합니다. 클릭 위치는 pos 으로 정의되며 기본 위치는 창 중앙입니다. delay 을 지정하면 테스트는 버튼을 누르기 전과 버튼을 놓기 전에 지정된 시간(밀리초) 동안 기다립니다.

QTest::mousePress() 및 QTest::mouseRelease()도 참조하세요 .

void QTest::mouseDClick(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

widget 에서 선택 사항인 modifier 을 사용하여 마우스 button 를 두 번 클릭하는 것을 시뮬레이션합니다. 클릭 위치는 pos 으로 정의되며, 기본 위치는 위젯의 중앙입니다. delay 을 지정하면 테스트는 누르고 놓을 때마다 지정된 시간(밀리초) 동안 기다립니다.

QTest::mouseClick()도 참조하세요 .

void QTest::mouseDClick(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

이 함수는 오버로드된 함수입니다.

window 에서 선택적 stateKey 수정자를 사용하여 마우스 button 를 두 번 클릭하는 것을 시뮬레이션합니다. 클릭 위치는 pos 으로 정의되며 기본 위치는 창 중앙입니다. delay 을 지정하면 테스트는 누르고 놓을 때마다 지정된 시간(밀리초) 동안 기다립니다.

QTest::mouseClick()도 참조하세요 .

void QTest::mouseMove(QWidget *widget, QPoint pos = QPoint(), int delay = -1)

마우스 포인터를 widget 로 이동합니다. pos 을 지정하지 않으면 마우스 포인터가 위젯의 중앙으로 이동합니다. delay (밀리초 단위)를 지정하면 마우스 포인터를 이동하기 전에 테스트가 대기합니다.

void QTest::mouseMove(QWindow *window, QPoint pos = QPoint(), int delay = -1)

이 기능은 오버로드된 기능입니다.

마우스 포인터를 window 로 이동합니다. pos 을 지정하지 않으면 마우스 포인터가 창 중앙으로 이동합니다. delay (밀리초 단위)를 지정하면 마우스 포인터를 이동하기 전에 테스트가 대기합니다.

void QTest::mousePress(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

widget 에서 선택 사항인 modifier 을 사용하여 마우스 button 를 누르는 것을 시뮬레이션합니다. 위치는 pos 으로 정의되며, 기본 위치는 위젯의 중앙입니다. delay 을 지정하면 테스트는 지정된 시간(밀리초) 동안 기다린 후 누릅니다.

QTest::mouseRelease() 및 QTest::mouseClick()도 참조하세요 .

void QTest::mousePress(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

이 함수는 오버로드된 함수입니다.

window 에서 선택적 stateKey 수정자를 사용하여 마우스 button 를 누르는 것을 시뮬레이션합니다. 위치는 pos 으로 정의되며 기본 위치는 창 중앙입니다. delay 을 지정하면 테스트는 지정된 시간(밀리초) 동안 기다린 후 누릅니다.

QTest::mouseRelease() 및 QTest::mouseClick()도 참조하세요 .

void QTest::mouseRelease(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

widget 에서 선택 사항인 modifier 을 사용하여 마우스 button 를 놓는 것을 시뮬레이션합니다. 놓는 위치는 pos 으로 정의되며, 기본 위치는 위젯의 중앙입니다. delay 을 지정하면 테스트는 버튼을 놓기 전에 지정된 시간(밀리초) 동안 대기하고, 그렇지 않으면 명령줄 인수를 통해 재정의할 수 있는 기본 시간(1ms) 동안 대기합니다.

QSignalSpy doubleClickSpy(target, &TargetClass::doubleClicked);
const QPoint p(1, 2);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p);
QVERIFY(target.isPressed());
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.isPressed(), false);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.pressCount(), 2);
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(doubleClickSpy.count(), 1);

QTest::mousePress() 및 QTest::mouseClick()도 참조하세요 .

void QTest::mouseRelease(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

이 함수는 오버로드된 함수입니다.

window 에서 선택적 stateKey 수정자를 사용하여 마우스 button 를 놓는 것을 시뮬레이션합니다. 놓는 위치는 pos 으로 정의되며, 기본 위치는 창 중앙입니다. delay 을 지정하면 테스트는 버튼을 놓기 전에 지정된 시간(밀리초) 동안 대기하고, 그렇지 않으면 명령줄 인수를 통해 재정의할 수 있는 기본 시간(1ms) 동안 대기합니다.

QSignalSpy doubleClickSpy(target, &TargetClass::doubleClicked);
const QPoint p(1, 2);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p);
QVERIFY(target.isPressed());
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.isPressed(), false);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.pressCount(), 2);
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(doubleClickSpy.count(), 1);

QTest::mousePress() 및 QTest::mouseClick()도 참조하세요 .

QTestData &QTest::newRow(const char *dataTag)

현재 테스트 데이터에 새 행을 추가합니다.

테스트 출력은 dataTag 이라는 이름을 사용하여 이 테스트 데이터로 실행된 테스트를 식별합니다.

테이블의 각 열에 대해 하나의 값씩 데이터를 스트리밍하는 데 사용할 수 있는 QTestData 참조를 반환합니다.

예시:

void MyTestClass::addSingleStringRows()
{
    QTest::addColumn<QString>("aString");
    QTest::newRow("just.hello") << QString("hello");
    QTest::newRow("a.null.string") << QString();
}

더 자세한 예는 데이터 기반 테스트를 참조하세요.

addRow(), addColumn() 및 QFETCH()도 참조하세요 .

int QTest::qExec(QObject *testObject, int argc = 0, char **argv = nullptr)

testObject 에 선언된 테스트를 실행합니다. 또한 비공개 슬롯 initTestCase(), cleanupTestCase(), init() 및 cleanup() 이 있는 경우 실행됩니다. 자세한 내용은 테스트 만들기를 참조하세요.

선택적으로 명령줄 인수 argc 및 argv 을 제공할 수 있습니다. 인식되는 인수 목록은 Qt Test 명령줄 인수를 참조하세요.

다음 예는 MyTestObject 의 모든 테스트를 실행합니다:

MyTestObject test1;
QTest::qExec(&test1);

이 함수는 테스트가 실패하지 않으면 0을 반환하고, 하나 이상의 테스트가 실패하거나 처리되지 않은 예외가 있는 경우 0 이외의 값을 반환합니다. (건너뛴 테스트는 반환 값에 영향을 미치지 않습니다.)

독립형 테스트 애플리케이션의 경우 편의 매크로 QTEST_MAIN()를 사용하여 명령줄 인수를 구문 분석하고 테스트를 실행하는 main() 함수를 선언할 수 있으므로 이 함수를 명시적으로 호출하지 않아도 됩니다.

이 함수의 반환 값은 QTEST_MAIN() 매크로를 사용할 때 테스트 애플리케이션의 종료 코드이기도 합니다.

독립형 테스트 애플리케이션의 경우 테스트 출력을 파일에 기록하고 개별 테스트 함수를 실행하는 명령줄 옵션이 올바르게 작동하지 않으므로 이 함수를 두 번 이상 호출해서는 안 됩니다.

main() 의 인수에서 인수를 가져오는 대신 프로그래밍 방식으로 인수를 생성한 경우, 유니코드에 안전하므로 QTest::qExec(QObject *, const QStringList &)을 사용하는 것이 좋습니다.

QTEST_MAIN(), QTEST_GUILESS_MAIN() 및 QTEST_APPLESS_MAIN()도 참조하세요 .

int QTest::qExec(QObject *testObject, const QStringList &arguments)

이 함수는 오버로드된 함수입니다.

qExec(QObject *, int, char**)과 동일하게 동작하지만 char** 목록 대신 arguments 의 QStringList 을 받습니다.

QSharedPointer<QTemporaryDir> QTest::qExtractTestData(const QString &dirName)

리소스에서 디스크로 디렉터리를 추출합니다. 콘텐츠는 임시 폴더로 재귀적으로 추출됩니다. 반환 값에 대한 마지막 참조가 범위를 벗어나면 추출된 콘텐츠는 자동으로 제거됩니다.

dirName 는 리소스에서 추출할 디렉터리의 이름입니다.

데이터가 추출된 임시 디렉터리를 반환하거나 오류가 있는 경우 null을 반환합니다.

[since 6.5] void QTest::qRegisterTestCase(const QString &name, QTest::TestEntryFunction entryFunction)

현재 바이너리에 대한 중앙 테스트 케이스 레지스트리에 입력 함수 entryFunction 를 사용하여 테스트 name 를 등록합니다.

일괄 테스트 바이너리를 매개 변수 없이 실행하면 name 이 나열됩니다. name 의 argv[1]로 테스트 바이너리를 실행하면 entryFunction 이 호출됩니다.

이 함수는 Qt 6.5에 도입되었습니다.

[since 6.7] void QTest::qSleep(std::chrono::milliseconds msecs)

잠자기 msecs, 테스트 실행을 차단합니다.

이 메서드는 이벤트 처리를 수행하지 않으며 테스트가 응답하지 않게 됩니다. 절전 모드 중에 네트워크 통신이 시간 초과될 수 있습니다. 비차단 절전을 수행하려면 QTest::qWait()를 사용하십시오.

msecs 는 0ms보다 커야 합니다.

예제:

using namespace std::chrono_literals;
QTest::qSleep(250ms);

이 함수는 Qt 6.7에 도입되었습니다.

QTest::qWait()도 참조하십시오 .

void QTest::qSleep(int ms)

이 함수는 과부하된 함수입니다.

ms 밀리초 동안 잠자기 상태로 테스트 실행을 차단합니다.

호출과 동일합니다:

QTest::qSleep(std::chrono::milliseconds{ms});

[since 6.7] void QTest::qWait(std::chrono::milliseconds msecs)

msecs 을 기다립니다. 대기하는 동안 이벤트가 처리되고 테스트는 사용자 인터페이스 이벤트 또는 네트워크 통신에 계속 반응합니다.

예시:

    using namespace std::chrono_literals;
    int i = 0;
    while (myNetworkServerNotResponding() && i++ < 50)
        QTest::qWait(250ms);

위의 코드는 네트워크 서버가 응답할 때까지 최대 약 12.5초 동안 대기합니다.

이 기능은 Qt 6.7에 도입되었습니다.

QTest::qSleep() 및 QSignalSpy::wait()도 참조하세요 .

void QTest::qWait(int msecs)

과부하가 걸린 함수입니다.

msecs 을 기다립니다. 호출과 동일합니다:

QTest::qWait(std::chrono::milliseconds{msecs});

[since 6.7] template <typename Functor> bool QTest::qWaitFor(Functor predicate, QDeadlineTimer deadline = QDeadlineTimer(std::chrono::seconds{5}))

deadline 이 만료될 때까지 또는 predicate 이 참을 반환할 때까지 기다립니다.

predicate 이 어느 시점에서든 참을 반환하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

예시:

    MyObject obj;
    obj.startup();
    using namespace std::chrono_literals;
    const bool result = QTest::qWaitFor([&obj]() { return obj.isReady(); },
                                        QDeadlineTimer(3s));

위의 코드는 객체가 준비될 때까지 최대 3초 동안 기다립니다.

이 함수는 Qt 6.7에 도입되었습니다.

template <typename Functor> bool QTest::qWaitFor(Functor predicate, int timeout)

이 함수는 오버로드된 함수입니다.

timeout 밀리초 동안 또는 predicate 이 참으로 반환될 때까지 기다립니다.

이는 호출과 동일합니다:

qWaitFor(predicate, QDeadlineTimer(timeout));

bool QTest::qWaitForWindowActive(QWidget *widget, int timeout = 5000)

widget 이 timeout 밀리초 이내에 활성화되면 true 을 반환합니다. 그렇지 않으면 false 을 반환합니다.

이 메서드는 QWidget::show()를 호출하고 진행하기 전에 위젯이 실제로 활성화되어 있는지(즉, 표시되고 포커스가 있는지) 확인하는 테스트에 유용합니다.

qWaitForWindowExposed() 및 QWidget::isActiveWindow()도 참조하세요 .

bool QTest::qWaitForWindowActive(QWindow *window, int timeout = 5000)

window 이 timeout 밀리초 이내에 활성화된 경우 true 을 반환합니다. 그렇지 않으면 false 을 반환합니다.

이 메서드는 QWindow::show()를 호출하고 계속 진행하기 전에 창이 실제로 활성화되어 있는지(즉, 표시되고 포커스가 있는지)를 확인하는 테스트에 유용합니다.

qWaitForWindowExposed(), qWaitForWindowFocused() 및 QWindow::isActive()도 참조하세요 .

bool QTest::qWaitForWindowExposed(QWidget *widget, int timeout = 5000)

widget 이 timeout 밀리초 이내에 노출되면 true 을 반환합니다. 그렇지 않으면 false 을 반환합니다.

이 메서드는 QWidget::show()를 호출하고 계속 진행하기 전에 위젯이 실제로 표시되는지에 의존하는 테스트에 유용합니다.

qWaitForWindowActive(), QWidget::isVisible() 및 QWindow::isExposed()도 참조하세요 .

bool QTest::qWaitForWindowExposed(QWindow *window, int timeout = 5000)

window 이 timeout 밀리초 이내에 노출되면 true 을 반환합니다. 그렇지 않으면 false 을 반환합니다.

이 메서드는 QWindow::show()를 호출하고 계속 진행하기 전에 창이 실제로 표시되는지에 의존하는 테스트에 유용합니다.

qWaitForWindowActive() 및 QWindow::isExposed()도 참조하세요 .

[since 6.7] bool QTest::qWaitForWindowFocused(QWidget *widget, QDeadlineTimer timeout = std::chrono::seconds{5})

widget 이 timeout 내의 포커스 창인 경우 true 을 반환합니다. 그렇지 않으면 false 을 반환합니다.

이 메서드는 QWidget::show()를 호출하고 계속 진행하기 전에 포커스가 있는 위젯(예: 키보드 이벤트 수신)에 의존하는 테스트에 유용합니다.

이 함수는 Qt 6.7에 도입되었습니다.

qWaitForWindowExposed(), qWaitForWindowActive() 및 QGuiApplication::focusWindow()도 참조하십시오 .

[since 6.7] bool QTest::qWaitForWindowFocused(QWindow *window, QDeadlineTimer timeout = std::chrono::seconds{5})

window 이 timeout 내의 포커스 창인 경우 true 을 반환합니다. 그렇지 않으면 false 을 반환합니다.

이 메서드는 QWindow::show()를 호출하고 계속 진행하기 전에 포커스가 있는 창(예: 키보드 이벤트 수신 등)에 의존하는 테스트에 유용합니다.

이 함수는 Qt 6.7에 도입되었습니다.

qWaitForWindowExposed(), qWaitForWindowActive() 및 QGuiApplication::focusWindow()도 참조하십시오 .

void QTest::setBenchmarkResult(qreal result, QTest::QBenchmarkMetric metric)

이 테스트 함수에 대한 벤치마크 결과를 result 로 설정합니다.

QBENCHMARK 매크로를 사용하지 않고 벤치마크 결과를 보고하려면 이 함수를 사용합니다. metric 을 사용하여 Qt Test 이 결과를 해석하는 방법을 지정합니다.

결과의 컨텍스트는 테스트 함수 이름과 _data 함수의 데이터 태그입니다. 이 함수는 각 테스트 함수에서 한 번만 호출할 수 있으며, 이후 호출은 이전에 보고된 결과를 대체합니다.

반복 명령줄 인수는 QBENCHMARK 매크로가 없는 테스트 함수에는 영향을 미치지 않습니다.

[noexcept, since 6.8] void QTest::setThrowOnFail(bool enable)

QCOMPARE()/QVERIFY() 실패 시 (바로 주변 함수 컨텍스트에서 반환하는 것과는 반대로) 활성화(enable = true)하거나 비활성화( enable = false)합니다.

이 기능은 참조 카운트됩니다: true 로 이 함수를 N 번 호출하면 false 로 N 번 호출해야 시작한 위치로 돌아갈 수 있습니다.

기본값은 QTEST_THROW_ON_FAIL 환경 변수가 설정되어 있지 않은 경우 false 입니다.

QTEST_THROW_ON_FAIL C++ 매크로가 정의된 경우에는 이 호출이 적용되지 않습니다.

이 함수는 Qt 6.8에 도입되었습니다.

setThrowOnSkip(), ThrowOnFailEnabler, ThrowOnFailDisabler, QTEST_THROW_ON_FAIL 을참조하세요 .

[noexcept, since 6.8] void QTest::setThrowOnSkip(bool enable)

활성화(enable = true)하거나 비활성화( enable = false)하여 QSKIP()에 던집니다(바로 주변 함수 컨텍스트에서 반환하는 것과는 반대로).

이 기능은 참조 카운트됩니다: true 로 이 함수를 N 번 호출하면 false 로 N 번 호출해야 시작한 위치로 돌아갈 수 있습니다.

기본값은 QTEST_THROW_ON_SKIP 환경 변수가 설정되어 있지 않은 경우 false 입니다.

QTEST_THROW_ON_SKIP C++ 매크로가 정의된 경우에는 이 호출이 적용되지 않습니다.

이 함수는 Qt 6.8에 도입되었습니다.

setThrowOnFail(), ThrowOnSkipEnabler, ThrowOnSkipDisabler, QTEST_THROW_ON_SKIP 을참조하세요 .

char *QTest::toHexRepresentation(const char *ba, qsizetype length)

공백으로 구분된 16진수 문자열 시퀀스로 표현되는 ba 문자열에 대한 포인터를 반환합니다. 입력이 너무 길다고 판단되면 잘립니다. 반환된 문자열에는 끝에 줄임표가 표시됩니다. 호출자는 반환된 포인터의 소유권을 가지며 나중에 삭제[] 연산자에게 전달되도록 해야 합니다.

length 는 문자열의 길이입니다 ba.

char *toString(QSizePolicy sp)

이 함수는 오버로드된 함수입니다.

크기 정책의 텍스트 표현을 반환합니다 sp.

template <typename T> char *QTest::toString(const T &value)

value 의 텍스트 표현을 반환합니다. 이 함수는 QCOMPARE()에서 테스트 실패 시 자세한 정보를 출력하는 데 사용됩니다.

이 함수의 특수화 또는 오버로드를 테스트에 추가하여 자세한 정보 출력을 활성화할 수 있습니다.

전문화 예제(Qt ≤ 5.4):

namespace QTest {
    template<>
    char *toString(const MyPoint &point)
    {
        const QByteArray ba("MyPoint("
                            + QByteArray::number(point.x()) + ", "
                            + QByteArray::number(point.y()) + ')');
        return qstrdup(ba.data());
    }
}

위의 예는 MyPoint 라는 클래스에 대한 toString() 특수화를 정의합니다. MyPoint 의 두 인스턴스 비교가 실패할 때마다 QCOMPARE()는 이 함수를 호출하여 MyPoint 의 내용을 테스트 로그에 출력합니다.

동일한 예제이지만 오버로드를 사용합니다(Qt ≥ 5.5):

namespace {
    char *toString(const MyPoint &point)
    {
        return QTest::toString("MyPoint(" +
                               QByteArray::number(point.x()) + ", " +
                               QByteArray::number(point.y()) + ')');
    }
}

QCOMPARE()도 참조하세요 .

char *QTest::toString(const QVector4D &v)

이 함수는 오버로드된 함수입니다.

4D 벡터의 텍스트 표현을 반환합니다 v.

template <typename T1, typename T2> char *QTest::toString(const std::pair<T1, T2> &pair)

이 함수는 오버로드된 함수입니다.

pair 의 텍스트 표현을 반환합니다.

template <typename... Types> char *QTest::toString(const std::tuple<Types...> &tuple)

이 함수는 오버로드된 함수입니다.

주어진 tuple 의 텍스트 표현을 반환합니다.

char *QTest::toString(std::nullptr_t)

이 함수는 오버로드된 함수입니다.

nullptr 을 포함하는 문자열을 반환합니다.

char *toString(QSizePolicy::ControlType ct)

이 함수는 오버로드된 함수입니다.

제어 유형 ct 의 텍스트 표현을 반환합니다.

char *toString(QSizePolicy::ControlTypes cts)

이 함수는 오버로드된 함수입니다.

컨트롤 유형의 텍스트 표현을 반환합니다 cts.

char *toString(QSizePolicy::Policy p)

이 함수는 오버로드된 함수입니다.

정책의 텍스트 표현을 반환합니다 p.

char *QTest::toString(const QByteArray &ba)

이 함수는 오버로드된 함수입니다.

바이트 배열의 텍스트 표현을 반환합니다 ba.

QTest::toHexRepresentation()도 참조하세요 .

char *QTest::toString(const QCborError &c)

이 함수는 오버로드된 함수입니다.

주어진 CBOR 오류의 텍스트 표현을 반환합니다 c.

char *QTest::toString(const QChar &character)

이 함수는 오버로드된 함수입니다.

주어진 character 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QDate &date)

이 함수는 오버로드된 함수입니다.

주어진 date 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QDateTime &dateTime)

이 함수는 오버로드된 함수입니다.

dateTime 에 지정된 날짜와 시간의 텍스트 표현을 반환합니다.

[since 6.5] char *QTest::toString(const QKeySequence &ks)

이 함수는 오버로드된 함수입니다.

키 시퀀스의 텍스트 표현을 반환합니다 ks.

이 함수는 Qt 6.5에 도입되었습니다.

char *QTest::toString(const QLatin1StringView &string)

이 함수는 오버로드된 함수입니다.

주어진 string 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QPoint &point)

이 함수는 오버로드된 함수입니다.

주어진 point 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QPointF &point)

이 함수는 오버로드된 함수입니다.

주어진 point 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QRect &rectangle)

이 함수는 오버로드된 함수입니다.

주어진 rectangle 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QRectF &rectangle)

이 함수는 오버로드된 함수입니다.

주어진 rectangle 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QSize &size)

이 함수는 오버로드된 함수입니다.

주어진 size 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QSizeF &size)

이 함수는 오버로드된 함수입니다.

주어진 size 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QString &string)

이 함수는 오버로드된 함수입니다.

주어진 string 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QStringView &string)

이 함수는 오버로드된 함수입니다.

주어진 string 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QTime &time)

이 함수는 오버로드된 함수입니다.

주어진 time 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QUrl &url)

이 함수는 오버로드된 함수입니다.

주어진 url 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QUuid &uuid)

이 함수는 오버로드된 함수입니다.

주어진 uuid 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QVariant &variant)

이 함수는 오버로드된 함수입니다.

주어진 variant 의 텍스트 표현을 반환합니다.

char *QTest::toString(const QVector2D &v)

이 함수는 오버로드된 함수입니다.

2D 벡터의 텍스트 표현을 반환합니다 v.

char *QTest::toString(const QVector3D &v)

이 함수는 오버로드된 함수입니다.

3D 벡터의 텍스트 표현을 반환합니다 v.

QTest::QTouchEventWidgetSequence QTest::touchEvent(QWidget *widget, QPointingDevice *device, bool autoCommit = true)

device 에 대한 이벤트를 시뮬레이션하기 위해 widget 에 대한 QTouchEventSequence 을 생성하고 반환합니다.

시퀀스에 터치 이벤트를 추가할 때, press(), move() 등의 각 호출에서 다른 위젯이 제공되지 않는 한 widget 는 제공된 위치를 화면 좌표로 변환하는 데에도 사용됩니다.

터치 이벤트는 autoCommit 이 false로 설정되지 않는 한 QTouchEventSequence 의 소멸자가 호출될 때(즉, 반환된 객체의 범위가 초과될 때) 이벤트 시스템에 커밋됩니다. autoCommit 이 거짓이면 commit()을 수동으로 호출해야 합니다.

createTouchDevice()를 호출하여 이 함수와 함께 사용할 테스트 터치 디바이스를 만들 수 있습니다.

QTest::QTouchEventSequence QTest::touchEvent(QWindow *window, QPointingDevice *device, bool autoCommit = true)

device 에 대한 이벤트를 시뮬레이션하기 위해 window 에 대한 QTouchEventSequence 을 생성하고 반환합니다.

시퀀스에 터치 이벤트를 추가할 때, window 는 press(), move() 등의 호출에서 다른 창이 제공되지 않는 한 제공된 위치를 화면 좌표로 변환하는 데에도 사용됩니다.

터치 이벤트는 autoCommit 이 거짓으로 설정되지 않는 한 QTouchEventSequence 의 소멸자가 호출될 때(즉, 반환된 객체의 범위가 초과될 때) 이벤트 시스템에 커밋됩니다. autoCommit 이 false인 경우 commit()을 수동으로 호출해야 합니다.

createTouchDevice()를 호출하여 이 함수와 함께 사용할 테스트 터치 디바이스를 만들 수 있습니다.

[since 6.8] void QTest::wheelEvent(QWindow *window, QPointF pos, QPoint angleDelta, QPoint pixelDelta = QPoint(0, 0), Qt::KeyboardModifiers stateKey = Qt::NoModifier, Qt::ScrollPhase phase = Qt::NoScrollPhase)

로컬 창 좌표의 pos 위치에서 window 내의 휠 이벤트를 시뮬레이션합니다. angleDelta 휠 회전 각도를 포함합니다. 양수 값은 전진 회전을, 음수 값은 후진을 의미합니다. pixelDelta 에는 화면의 스크롤 거리(픽셀)가 포함됩니다. 이 값은 null일 수 있습니다. 이벤트 발생 시 키보드 상태는 stateKey 에 의해 지정됩니다. 이벤트의 스크롤 단계는 phase 에 의해 지정됩니다.

이 함수는 Qt 6.8에 도입되었습니다.