QWindowsWindowFunctions Class

The QWindowsWindowFunctions class is an inline class containing miscellaneous functionality for Windows window specific functionality. More...

Header: #include <QWindowsWindowFunctions>
Since: Qt 5.5

Public Types

typedef SetHasBorderInFullScreen
typedef SetTouchWindowTouchType
enum TouchWindowTouchType { NormalTouch, FineTouch, WantPalmTouch }
flags TouchWindowTouchTypes

Static Public Members

void setHasBorderInFullScreen(QWindow *window, bool border)
const QByteArray setHasBorderInFullScreenIdentifier()
void setTouchWindowTouchType(QWindow *window, TouchWindowTouchTypes type)
const QByteArray setTouchWindowTouchTypeIdentifier()

Detailed Description

The QWindowsWindowFunctions class is an inline class containing miscellaneous functionality for Windows window specific functionality.

A common usage pattern is as follows:

int main(int argc, char **argv)
{
    QApplication app(argc, argv);

    QPushButton topLevelWidget("Hello World!");
    topLevelWidget.winId(); //have to create the QWindow

    QWindow *tlwWindow = topLevelWidget.windowHandle();

    QWindowsWindowFunctions::setTouchWindowTouchType(tlwWindow, QWindowsWindowFunctions::WantPalmTouch);

    topLevelWidget.show();

    return app.exec();
}

Note: There is no binary compatibility guarantee for this class, meaning that an application using it is only guaranteed to work with the Qt version it was developed against.

Member Type Documentation

typedef QWindowsWindowFunctions::SetHasBorderInFullScreen

This is the typedef for the function returned by QGuiApplication::platformFunction when passed setHasBorderInFullScreenIdentifier.

typedef QWindowsWindowFunctions::SetTouchWindowTouchType

This is the typedef for the function returned by QGuiApplication::platformFunction when passed setTouchWindowTouchTypeIdentifier.

enum QWindowsWindowFunctions::TouchWindowTouchType
flags QWindowsWindowFunctions::TouchWindowTouchTypes

This enum represents the supported TouchWindow touch flags for RegisterTouchWindow().

ConstantValue
QWindowsWindowFunctions::NormalTouch0x00000000
QWindowsWindowFunctions::FineTouch0x00000001
QWindowsWindowFunctions::WantPalmTouch0x00000002

The TouchWindowTouchTypes type is a typedef for QFlags<TouchWindowTouchType>. It stores an OR combination of TouchWindowTouchType values.

Member Function Documentation

[static] void QWindowsWindowFunctions::setHasBorderInFullScreen(QWindow *window, bool border)

This is a convenience function that can be used directly instead of resolving the function pointer. window and border will be relayed to the function retrieved by QGuiApplication. When border is true then it will enable the WS_BORDER flag in full screen mode to enable other top level windows inside the application to appear on top when required.

See also Fullscreen OpenGL Based Windows

This function was introduced in Qt 5.6.

[static] const QByteArray QWindowsWindowFunctions::setHasBorderInFullScreenIdentifier()

This function returns the bytearray that can be used to query QGuiApplication::platformFunction to retrieve the SetHasBorderInFullScreen function.

This function was introduced in Qt 5.6.

[static] void QWindowsWindowFunctions::setTouchWindowTouchType(QWindow *window, TouchWindowTouchTypes type)

This is a convenience function that can be used directly instead of resolving the function pointer. window and type will be relayed to the function retrieved by QGuiApplication

[static] const QByteArray QWindowsWindowFunctions::setTouchWindowTouchTypeIdentifier()

This function returns the bytearray that can be used to query QGuiApplication::platformFunction to retrieve the SetTouchWindowTouchType function.

© 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.