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 IsTabletModeType
typedef SetHasBorderInFullScreen
typedef SetTouchWindowTouchType
typedef SetWindowActivationBehaviorType
enum TouchWindowTouchType { NormalTouch, FineTouch, WantPalmTouch }

Public Functions

int Q_DECLARE_FLAGS(int, QWindowsWindowFunctions::TouchWindowTouchType)

Static Public Members

bool isTabletMode()
const int isTabletModeIdentifier()
void setHasBorderInFullScreen(int *window, bool border)
const int setHasBorderInFullScreenIdentifier()
void setTouchWindowTouchType(int *window, int type)
const int setTouchWindowTouchTypeIdentifier()
void setWindowActivationBehavior(int behavior)
const int setWindowActivationBehaviorIdentifier()

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::IsTabletModeType

This is the typedef for the function returned by QGuiApplication::platformFunction() when passed isTabletModeIdentifier().

This typedef was introduced in Qt 5.9.

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.

typedef QWindowsWindowFunctions::SetWindowActivationBehaviorType

This is the typedef for the function returned by QGuiApplication::platformFunction() when passed setWindowActivationBehaviorIdentifier().

This typedef was introduced in Qt 5.7.

See also QWidget::activateWindow() and QWindow::requestActivate().

enum QWindowsWindowFunctions::TouchWindowTouchType

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

Constant Value
QWindowsWindowFunctions::NormalTouch 0x00000000
QWindowsWindowFunctions::FineTouch 0x00000001
QWindowsWindowFunctions::WantPalmTouch 0x00000002

Member Function Documentation

int QWindowsWindowFunctions::Q_DECLARE_FLAGS(int, QWindowsWindowFunctions::TouchWindowTouchType)

[static] bool QWindowsWindowFunctions::isTabletMode()

This is a convenience function that can be used directly instead of resolving the function pointer. Returns true if Windows 10 operates in Tablet Mode. In this mode, Windows forces all application main windows to open in maximized state. Applications should then avoid resizing windows or restoring geometries to non-maximized states.

This function was introduced in Qt 5.9.

See also QWidget::showMaximized(), QWidget::saveGeometry(), and QWidget::restoreGeometry().

[static] const int QWindowsWindowFunctions::isTabletModeIdentifier()

Returns a bytearray that can be used to query QGuiApplication::platformFunction() to retrieve the IsTabletModeType function.

This function was introduced in Qt 5.9.

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

[static] const int 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(int *window, int type)

[static] const int QWindowsWindowFunctions::setTouchWindowTouchTypeIdentifier()

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

[static] void QWindowsWindowFunctions::setWindowActivationBehavior(int behavior)

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

This function was introduced in Qt 5.7.

See also QWidget::activateWindow() and QWindow::requestActivate().

[static] const int QWindowsWindowFunctions::setWindowActivationBehaviorIdentifier()

This function returns a bytearray that can be used to query QGuiApplication::platformFunction() to retrieve the SetWindowActivationBehaviorType function.

This function was introduced in Qt 5.7.

See also QWidget::activateWindow() and QWindow::requestActivate().

Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
FREE!
create apps
create games
cross platform
native performance
3rd party services
game network
multiplayer
level editor
easiest to learn
biggest time saving
best support