summaryrefslogtreecommitdiffstats
path: root/tests/auto/gui/kernel/qwindow/tst_foreignwindow.cpp
blob: e7b05e70374dbdb565ebef00abf52d5ce3b4895e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only

#include <QTest>

#include <QtCore/qloggingcategory.h>
#include <private/qguiapplication_p.h>
#include <qpa/qplatformintegration.h>

#include "../../../../shared/nativewindow.h"

class tst_ForeignWindow: public QObject
{
    Q_OBJECT

private slots:
    void initTestCase()
    {
        auto *platformIntegration = QGuiApplicationPrivate::platformIntegration();
        if (!platformIntegration->hasCapability(QPlatformIntegration::ForeignWindows))
            QSKIP("This platform does not support foreign windows");
    }

    void fromWinId();
    void initialState();

    void embedForeignWindow();
    void embedInForeignWindow();
};

void tst_ForeignWindow::fromWinId()
{
    NativeWindow nativeWindow;
    QVERIFY(nativeWindow);

    std::unique_ptr<QWindow> foreignWindow(QWindow::fromWinId(nativeWindow));
    QVERIFY(foreignWindow);
    QVERIFY(foreignWindow->flags().testFlag(Qt::ForeignWindow));
    QVERIFY(foreignWindow->handle());

    // fromWinId does not take (exclusive) ownership of the native window,
    // so deleting the foreign window should not be a problem/cause crashes.
    foreignWindow.reset();
}

void tst_ForeignWindow::initialState()
{
    NativeWindow nativeWindow;
    QVERIFY(nativeWindow);

    // A foreign window can be used to embed a Qt UI in a foreign window hierarchy,
    // in which case the foreign window merely acts as a parent and should not be
    // modified, or to embed a foreign window in a Qt UI, in which case the foreign
    // window must to be able to re-parent, move, resize, show, etc, so that the
    // containing Qt UI can treat it as any other window.

    // At the point of creation though, we don't know what the foreign window
    // will be used for, so the platform should not assume it can modify the
    // window. Any properties set on the native window should persist past
    // creation of the foreign window.

    const QRect initialGeometry(123, 456, 321, 654);
    nativeWindow.setGeometry(initialGeometry);
    QTRY_COMPARE(nativeWindow.geometry(), initialGeometry);

    std::unique_ptr<QWindow> foreignWindow(QWindow::fromWinId(nativeWindow));
    QCOMPARE(nativeWindow.geometry(), initialGeometry);

    // For extra bonus points, the foreign window should actually
    // reflect the state of the native window.
    QCOMPARE(foreignWindow->geometry(), initialGeometry);
}

void tst_ForeignWindow::embedForeignWindow()
{
    // A foreign window embedded into a Qt UI requires that the rest of Qt
    // is to be able to treat the foreign child window as any other window
    // that it can show, hide, stack, and move around.

    QWindow parentWindow;

    NativeWindow nativeWindow;
    QVERIFY(nativeWindow);

    // As a prerequisite to that, we must be able to reparent the foreign window
    std::unique_ptr<QWindow> foreignWindow(QWindow::fromWinId(nativeWindow));
    foreignWindow->setParent(&parentWindow);
    QTRY_COMPARE(nativeWindow.parentWinId(), parentWindow.winId());

    // FIXME: This test is flakey on Linux. Figure out why
#if !defined(Q_OS_LINUX)
    foreignWindow->setParent(nullptr);
    QTRY_VERIFY(nativeWindow.parentWinId() != parentWindow.winId());
#endif
}

void tst_ForeignWindow::embedInForeignWindow()
{
    // When a foreign window is used as a container to embed a Qt UI
    // in a foreign window hierarchy, the foreign window merely acts
    // as a parent, and should not be modified.

    {
        // At a minimum, we must be able to reparent into the window
        NativeWindow nativeWindow;
        QVERIFY(nativeWindow);

        std::unique_ptr<QWindow> foreignWindow(QWindow::fromWinId(nativeWindow));

        QWindow embeddedWindow;
        embeddedWindow.setParent(foreignWindow.get());
        QTRY_VERIFY(nativeWindow.isParentOf(embeddedWindow.winId()));
    }

    {
        // The foreign window's native window should not be reparent as a
        // result of creating the foreign window, adding and removing children,
        // or destroying the foreign window.

        NativeWindow topLevelNativeWindow;
        NativeWindow childNativeWindow;
        childNativeWindow.setParent(topLevelNativeWindow);
        QVERIFY(topLevelNativeWindow.isParentOf(childNativeWindow));

        std::unique_ptr<QWindow> foreignWindow(QWindow::fromWinId(childNativeWindow));
        QVERIFY(topLevelNativeWindow.isParentOf(childNativeWindow));

        QWindow embeddedWindow;
        embeddedWindow.setParent(foreignWindow.get());
        QTRY_VERIFY(childNativeWindow.isParentOf(embeddedWindow.winId()));
        QVERIFY(topLevelNativeWindow.isParentOf(childNativeWindow));

        embeddedWindow.setParent(nullptr);
        QVERIFY(topLevelNativeWindow.isParentOf(childNativeWindow));

        foreignWindow.reset();
        QVERIFY(topLevelNativeWindow.isParentOf(childNativeWindow));
    }
}

#include <tst_foreignwindow.moc>
QTEST_MAIN(tst_ForeignWindow)