| /**************************************************************************** |
| ** |
| ** Copyright (C) 2017 The Qt Company Ltd. |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the test suite of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:BSD$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** BSD License Usage |
| ** Alternatively, you may use this file under the terms of the BSD license |
| ** as follows: |
| ** |
| ** "Redistribution and use in source and binary forms, with or without |
| ** modification, are permitted provided that the following conditions are |
| ** met: |
| ** * Redistributions of source code must retain the above copyright |
| ** notice, this list of conditions and the following disclaimer. |
| ** * Redistributions in binary form must reproduce the above copyright |
| ** notice, this list of conditions and the following disclaimer in |
| ** the documentation and/or other materials provided with the |
| ** distribution. |
| ** * Neither the name of The Qt Company Ltd nor the names of its |
| ** contributors may be used to endorse or promote products derived |
| ** from this software without specific prior written permission. |
| ** |
| ** |
| ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| import QtQuick 2.12 |
| import QtTest 1.0 |
| import QtQuick.Controls 2.12 |
| |
| TestCase { |
| id: testCase |
| width: 200 |
| height: 200 |
| visible: true |
| when: windowShown |
| name: "Button" |
| |
| Component { |
| id: button |
| Button { } |
| } |
| |
| Component { |
| id: signalSequenceSpy |
| SignalSequenceSpy { |
| signals: ["pressed", "released", "canceled", "clicked", "toggled", "doubleClicked", "pressedChanged", "downChanged", "checkedChanged"] |
| } |
| } |
| |
| Component { |
| id: signalSpy |
| SignalSpy { } |
| } |
| |
| function test_text() { |
| var control = createTemporaryObject(button, testCase) |
| verify(control) |
| |
| compare(control.text, "") |
| control.text = "Button" |
| compare(control.text, "Button") |
| control.text = "" |
| compare(control.text, "") |
| } |
| |
| function test_mouse() { |
| var control = createTemporaryObject(button, testCase) |
| verify(control) |
| |
| var sequenceSpy = signalSequenceSpy.createObject(control, {target: control}) |
| |
| // click |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": true }], |
| ["downChanged", { "down": true }], |
| "pressed"] |
| mousePress(control, control.width / 2, control.height / 2, Qt.LeftButton) |
| compare(control.pressed, true) |
| verify(sequenceSpy.success) |
| |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": false }], |
| ["downChanged", { "down": false }], |
| "released", |
| "clicked"] |
| mouseRelease(control, control.width / 2, control.height / 2, Qt.LeftButton) |
| compare(control.pressed, false) |
| verify(sequenceSpy.success) |
| |
| // release outside |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": true }], |
| ["downChanged", { "down": true }], |
| "pressed"] |
| mousePress(control, control.width / 2, control.height / 2, Qt.LeftButton) |
| compare(control.pressed, true) |
| verify(sequenceSpy.success) |
| |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": false }], |
| ["downChanged", { "down": false }]] |
| mouseMove(control, control.width * 2, control.height * 2, 0) |
| compare(control.pressed, false) |
| verify(sequenceSpy.success) |
| |
| sequenceSpy.expectedSequence = [["canceled", { "pressed": false }]] |
| mouseRelease(control, control.width * 2, control.height * 2, Qt.LeftButton) |
| compare(control.pressed, false) |
| verify(sequenceSpy.success) |
| |
| // right button |
| sequenceSpy.expectedSequence = [] |
| mousePress(control, control.width / 2, control.height / 2, Qt.RightButton) |
| compare(control.pressed, false) |
| |
| mouseRelease(control, control.width / 2, control.height / 2, Qt.RightButton) |
| compare(control.pressed, false) |
| verify(sequenceSpy.success) |
| |
| // double click |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": true }], |
| ["downChanged", { "down": true }], |
| "pressed", |
| ["pressedChanged", { "pressed": false }], |
| ["downChanged", { "down": false }], |
| "released", |
| "clicked", |
| ["pressedChanged", { "pressed": true }], |
| ["downChanged", { "down": true }], |
| "pressed", |
| "doubleClicked", |
| ["pressedChanged", { "pressed": false }], |
| ["downChanged", { "down": false }], |
| "released"] |
| mouseDoubleClickSequence(control, control.width / 2, control.height / 2, Qt.LeftButton) |
| verify(sequenceSpy.success) |
| } |
| |
| function test_touch() { |
| var control = createTemporaryObject(button, testCase) |
| verify(control) |
| |
| var touch = touchEvent(control) |
| var sequenceSpy = signalSequenceSpy.createObject(control, {target: control}) |
| |
| // click |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": true }], |
| ["downChanged", { "down": true }], |
| "pressed"] |
| touch.press(0, control, control.width / 2, control.height / 2).commit() |
| compare(control.pressed, true) |
| verify(sequenceSpy.success) |
| |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": false }], |
| ["downChanged", { "down": false }], |
| "released", |
| "clicked"] |
| touch.release(0, control, control.width / 2, control.height / 2).commit() |
| compare(control.pressed, false) |
| verify(sequenceSpy.success) |
| |
| // release outside |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": true }], |
| ["downChanged", { "down": true }], |
| "pressed"] |
| touch.press(0, control, control.width / 2, control.height / 2).commit() |
| compare(control.pressed, true) |
| verify(sequenceSpy.success) |
| |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": false }], |
| ["downChanged", { "down": false }]] |
| touch.move(0, control, control.width * 2, control.height * 2).commit() |
| compare(control.pressed, false) |
| verify(sequenceSpy.success) |
| |
| sequenceSpy.expectedSequence = [["canceled", { "pressed": false }]] |
| touch.release(0, control, control.width * 2, control.height * 2).commit() |
| compare(control.pressed, false) |
| verify(sequenceSpy.success) |
| } |
| |
| function test_multiTouch() { |
| var control1 = createTemporaryObject(button, testCase) |
| verify(control1) |
| |
| var pressedCount1 = 0 |
| |
| var pressedSpy1 = signalSpy.createObject(control1, {target: control1, signalName: "pressedChanged"}) |
| verify(pressedSpy1.valid) |
| |
| var touch = touchEvent(control1) |
| touch.press(0, control1, 0, 0).commit().move(0, control1, control1.width, control1.height).commit() |
| |
| compare(pressedSpy1.count, ++pressedCount1) |
| compare(control1.pressed, true) |
| |
| // second touch point on the same control is ignored |
| touch.stationary(0).press(1, control1, 0, 0).commit() |
| touch.stationary(0).move(1, control1).commit() |
| touch.stationary(0).release(1).commit() |
| |
| compare(pressedSpy1.count, pressedCount1) |
| compare(control1.pressed, true) |
| |
| var control2 = createTemporaryObject(button, testCase, {y: control1.height}) |
| verify(control2) |
| |
| var pressedCount2 = 0 |
| |
| var pressedSpy2 = signalSpy.createObject(control2, {target: control2, signalName: "pressedChanged"}) |
| verify(pressedSpy2.valid) |
| |
| // press the second button |
| touch.stationary(0).press(2, control2, 0, 0).commit() |
| |
| compare(pressedSpy2.count, ++pressedCount2) |
| compare(control2.pressed, true) |
| |
| compare(pressedSpy1.count, pressedCount1) |
| compare(control1.pressed, true) |
| |
| // release both buttons |
| touch.release(0, control1).release(2, control2).commit() |
| |
| compare(pressedSpy2.count, ++pressedCount2) |
| compare(control2.pressed, false) |
| |
| compare(pressedSpy1.count, ++pressedCount1) |
| compare(control1.pressed, false) |
| } |
| |
| function test_keys() { |
| var control = createTemporaryObject(button, testCase) |
| verify(control) |
| |
| control.forceActiveFocus() |
| verify(control.activeFocus) |
| |
| var sequenceSpy = signalSequenceSpy.createObject(control, {target: control}) |
| |
| // click |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": true }], |
| ["downChanged", { "down": true }], |
| "pressed", |
| ["pressedChanged", { "pressed": false }], |
| ["downChanged", { "down": false }], |
| "released", |
| "clicked"] |
| keyClick(Qt.Key_Space) |
| verify(sequenceSpy.success) |
| |
| // no change |
| sequenceSpy.expectedSequence = [] |
| var keys = [Qt.Key_Enter, Qt.Key_Return, Qt.Key_Escape, Qt.Key_Tab] |
| for (var i = 0; i < keys.length; ++i) { |
| sequenceSpy.reset() |
| keyClick(keys[i]) |
| verify(sequenceSpy.success) |
| } |
| } |
| |
| function eventErrorMessage(actual, expected) { |
| return "actual event:" + JSON.stringify(actual) + ", expected event:" + JSON.stringify(expected) |
| } |
| |
| function test_autoRepeat() { |
| var control = createTemporaryObject(button, testCase) |
| verify(control) |
| |
| compare(control.autoRepeat, false) |
| control.autoRepeat = true |
| compare(control.autoRepeat, true) |
| |
| control.forceActiveFocus() |
| verify(control.activeFocus) |
| |
| var clickSpy = signalSpy.createObject(control, {target: control, signalName: "clicked"}) |
| verify(clickSpy.valid) |
| var pressSpy = signalSpy.createObject(control, {target: control, signalName: "pressed"}) |
| verify(pressSpy.valid) |
| var releaseSpy = signalSpy.createObject(control, {target: control, signalName: "released"}) |
| verify(releaseSpy.valid) |
| |
| // auto-repeat mouse click |
| mousePress(control) |
| compare(control.pressed, true) |
| clickSpy.wait() |
| clickSpy.wait() |
| compare(pressSpy.count, clickSpy.count + 1) |
| compare(releaseSpy.count, clickSpy.count) |
| mouseRelease(control) |
| compare(control.pressed, false) |
| compare(clickSpy.count, pressSpy.count) |
| compare(releaseSpy.count, pressSpy.count) |
| |
| clickSpy.clear() |
| pressSpy.clear() |
| releaseSpy.clear() |
| |
| // auto-repeat key click |
| keyPress(Qt.Key_Space) |
| compare(control.pressed, true) |
| clickSpy.wait() |
| clickSpy.wait() |
| compare(pressSpy.count, clickSpy.count + 1) |
| compare(releaseSpy.count, clickSpy.count) |
| keyRelease(Qt.Key_Space) |
| compare(control.pressed, false) |
| compare(clickSpy.count, pressSpy.count) |
| compare(releaseSpy.count, pressSpy.count) |
| |
| clickSpy.clear() |
| pressSpy.clear() |
| releaseSpy.clear() |
| |
| mousePress(control) |
| compare(control.pressed, true) |
| clickSpy.wait() |
| compare(pressSpy.count, clickSpy.count + 1) |
| compare(releaseSpy.count, clickSpy.count) |
| |
| // move inside during repeat -> continue repeat |
| mouseMove(control, control.width / 4, control.height / 4) |
| clickSpy.wait() |
| compare(pressSpy.count, clickSpy.count + 1) |
| compare(releaseSpy.count, clickSpy.count) |
| |
| clickSpy.clear() |
| pressSpy.clear() |
| releaseSpy.clear() |
| |
| // move outside during repeat -> stop repeat |
| mouseMove(control, -1, -1) |
| // NOTE: The following wait() is NOT a reliable way to test that the |
| // auto-repeat timer is not running, but there's no way dig into the |
| // private APIs from QML. If this test ever fails in the future, it |
| // indicates that the auto-repeat timer logic is broken. |
| wait(125) |
| compare(clickSpy.count, 0) |
| compare(pressSpy.count, 0) |
| compare(releaseSpy.count, 0) |
| |
| mouseRelease(control, -1, -1) |
| compare(control.pressed, false) |
| compare(clickSpy.count, 0) |
| compare(pressSpy.count, 0) |
| compare(releaseSpy.count, 0) |
| } |
| |
| function test_baseline() { |
| var control = createTemporaryObject(button, testCase) |
| verify(control) |
| compare(control.baselineOffset, control.contentItem.y + control.contentItem.baselineOffset) |
| } |
| |
| function test_checkable() { |
| var control = createTemporaryObject(button, testCase) |
| verify(control) |
| verify(control.hasOwnProperty("checkable")) |
| verify(!control.checkable) |
| |
| var sequenceSpy = signalSequenceSpy.createObject(control, {target: control}) |
| |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": true }], |
| ["downChanged", { "down": true }], |
| "pressed", |
| ["pressedChanged", { "pressed": false }], |
| ["downChanged", { "down": false }], |
| "released", |
| "clicked"] |
| mouseClick(control) |
| verify(!control.checked) |
| verify(sequenceSpy.success) |
| |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": true }], |
| ["downChanged", { "down": true }], |
| "pressed", |
| ["pressedChanged", { "pressed": false }], |
| ["downChanged", { "down": false }], |
| ["checkedChanged", { "checked": true }], |
| "toggled", |
| "released", |
| "clicked"] |
| control.checkable = true |
| mouseClick(control) |
| verify(control.checked) |
| verify(sequenceSpy.success) |
| |
| sequenceSpy.expectedSequence = [["pressedChanged", { "pressed": true }], |
| ["downChanged", { "down": true }], |
| "pressed", |
| ["pressedChanged", { "pressed": false }], |
| ["downChanged", { "down": false }], |
| ["checkedChanged", { "checked": false }], |
| "toggled", |
| "released", |
| "clicked"] |
| mouseClick(control) |
| verify(!control.checked) |
| verify(sequenceSpy.success) |
| } |
| |
| function test_highlighted() { |
| var control = createTemporaryObject(button, testCase) |
| verify(control) |
| verify(!control.highlighted) |
| |
| control.highlighted = true |
| verify(control.highlighted) |
| } |
| |
| function test_spacing() { |
| var control = createTemporaryObject(button, testCase, { text: "Some long, long, long text" }) |
| verify(control) |
| verify(control.contentItem.implicitWidth + control.leftPadding + control.rightPadding > control.background.implicitWidth) |
| |
| var textLabel = findChild(control.contentItem, "label") |
| verify(textLabel) |
| |
| // The implicitWidth of the IconLabel that all buttons use as their contentItem |
| // should be equal to the implicitWidth of the Text while no icon is set. |
| compare(control.contentItem.implicitWidth, textLabel.implicitWidth) |
| |
| // That means that spacing shouldn't affect it. |
| control.spacing += 100 |
| compare(control.contentItem.implicitWidth, textLabel.implicitWidth) |
| |
| // The implicitWidth of the Button itself should, therefore, also never include spacing while no icon is set. |
| compare(control.implicitWidth, textLabel.implicitWidth + control.leftPadding + control.rightPadding) |
| } |
| |
| function test_display_data() { |
| return [ |
| { "tag": "IconOnly", display: Button.IconOnly }, |
| { "tag": "TextOnly", display: Button.TextOnly }, |
| { "tag": "TextUnderIcon", display: Button.TextUnderIcon }, |
| { "tag": "TextBesideIcon", display: Button.TextBesideIcon }, |
| { "tag": "IconOnly, mirrored", display: Button.IconOnly, mirrored: true }, |
| { "tag": "TextOnly, mirrored", display: Button.TextOnly, mirrored: true }, |
| { "tag": "TextUnderIcon, mirrored", display: Button.TextUnderIcon, mirrored: true }, |
| { "tag": "TextBesideIcon, mirrored", display: Button.TextBesideIcon, mirrored: true } |
| ] |
| } |
| |
| function test_display(data) { |
| var control = createTemporaryObject(button, testCase, { |
| text: "Button", |
| display: data.display, |
| "icon.source": "qrc:/qt-project.org/imports/QtQuick/Controls.2/images/check.png", |
| "LayoutMirroring.enabled": !!data.mirrored |
| }) |
| verify(control) |
| compare(control.icon.source, "qrc:/qt-project.org/imports/QtQuick/Controls.2/images/check.png") |
| |
| var iconImage = findChild(control.contentItem, "image") |
| var textLabel = findChild(control.contentItem, "label") |
| |
| switch (control.display) { |
| case Button.IconOnly: |
| verify(iconImage) |
| verify(!textLabel) |
| compare(iconImage.x, (control.availableWidth - iconImage.width) / 2) |
| compare(iconImage.y, (control.availableHeight - iconImage.height) / 2) |
| break; |
| case Button.TextOnly: |
| verify(!iconImage) |
| verify(textLabel) |
| compare(textLabel.x, (control.availableWidth - textLabel.width) / 2) |
| compare(textLabel.y, (control.availableHeight - textLabel.height) / 2) |
| break; |
| case Button.TextUnderIcon: |
| verify(iconImage) |
| verify(textLabel) |
| compare(iconImage.x, (control.availableWidth - iconImage.width) / 2) |
| compare(textLabel.x, (control.availableWidth - textLabel.width) / 2) |
| verify(iconImage.y < textLabel.y) |
| break; |
| case Button.TextBesideIcon: |
| verify(iconImage) |
| verify(textLabel) |
| if (control.mirrored) |
| verify(textLabel.x < iconImage.x) |
| else |
| verify(iconImage.x < textLabel.x) |
| compare(iconImage.y, (control.availableHeight - iconImage.height) / 2) |
| compare(textLabel.y, (control.availableHeight - textLabel.height) / 2) |
| break; |
| } |
| } |
| } |