QWindowsApplication Struct

struct QNativeInterface::Private::QWindowsApplication

Native interface to QGuiApplication, to be retrieved from QPlatformIntegration. \inmodule QtGui \ingroup native-interfaces. More...

Header: #include <QWindowsApplication>

Public Types

flags DarkModeHandling
enum DarkModeHandlingFlag { DarkModeWindowFrames, DarkModeStyle }
enum TouchWindowTouchType { NormalTouch, FineTouch, WantPalmTouch }
flags TouchWindowTouchTypes
enum WindowActivationBehavior { DefaultActivateWindow, AlwaysActivateWindow }

Public Functions

virtual bool asyncExpose() const = 0
virtual HWND createMessageWindow(const QString &classNameTemplate, const QString &windowName, QFunctionPointer eventProc = nullptr) const = 0
virtual DarkModeHandling darkModeHandling() const = 0
virtual bool isDarkMode() const = 0
virtual bool isTabletMode() const = 0
virtual bool isWinTabEnabled() const = 0
virtual void registerMime(QWindowsMimeConverter *mime) = 0
virtual int registerMimeType(const QString &mime) = 0
virtual void setAsyncExpose(bool value) = 0
virtual void setDarkModeHandling(DarkModeHandling handling) = 0
virtual void setTouchWindowTouchType(TouchWindowTouchTypes type) = 0
virtual bool setWinTabEnabled(bool enabled) = 0
virtual void setWindowActivationBehavior(WindowActivationBehavior behavior) = 0
virtual TouchWindowTouchTypes touchWindowTouchType() const = 0
virtual void unregisterMime(QWindowsMimeConverter *mime) = 0
virtual WindowActivationBehavior windowActivationBehavior() const = 0

Detailed Description

\since6.0 \internal

Member Type Documentation

enum QWindowsApplication::DarkModeHandlingFlag
flags QWindowsApplication::DarkModeHandling

This enum specifies the behavior of the application when Windows is configured to use dark mode for applications.

ConstantValueDescription
QNativeInterface::Private::QWindowsApplication::DarkModeWindowFrames0x1The window frames will be switched to dark.
QNativeInterface::Private::QWindowsApplication::DarkModeStyle0x2The Windows Vista style will be turned off and a simple dark style will be used.

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

See also isDarkMode() and setDarkModeHandling().

enum QWindowsApplication::TouchWindowTouchType
flags QWindowsApplication::TouchWindowTouchTypes

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

ConstantValue
QNativeInterface::Private::QWindowsApplication::NormalTouch0x00000000
QNativeInterface::Private::QWindowsApplication::FineTouch0x00000001
QNativeInterface::Private::QWindowsApplication::WantPalmTouch0x00000002

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

enum QWindowsApplication::WindowActivationBehavior

This enum specifies the behavior of QWidget::activateWindow() and QWindow::requestActivate().

ConstantValueDescription
QNativeInterface::Private::QWindowsApplication::DefaultActivateWindow0The window is activated according to the default behavior of the Windows operating system. This means the window will not be activated in some circumstances (most notably when the calling process is not the active process); only the taskbar entry will be flashed.
QNativeInterface::Private::QWindowsApplication::AlwaysActivateWindow1The window is always activated, even when the calling process is not the active process.

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

Member Function Documentation

[pure virtual] bool QWindowsApplication::asyncExpose() const

\internal

See also setAsyncExpose().

[pure virtual] HWND QWindowsApplication::createMessageWindow(const QString &classNameTemplate, const QString &windowName, QFunctionPointer eventProc = nullptr) const

\internal

[pure virtual] DarkModeHandling QWindowsApplication::darkModeHandling() const

\internal

Returns the currently set dark mode handling.

See also setDarkModeHandling().

[pure virtual] bool QWindowsApplication::isDarkMode() const

\internal

Returns true if Windows 10 is configured to use dark mode for applications.

[pure virtual] bool QWindowsApplication::isTabletMode() const

\internal

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.

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

[pure virtual] bool QWindowsApplication::isWinTabEnabled() const

\internal

Returns whether the Tablet WinTab Driver (Wintab32.dll) is used.

[pure virtual] void QWindowsApplication::registerMime(QWindowsMimeConverter *mime)

\internal

Registers the converter mime to the system.

See also QWindowsMimeConverter and unregisterMime().

[pure virtual] int QWindowsApplication::registerMimeType(const QString &mime)

\internal

Registers the MIME type mime, and returns an ID number identifying the format on Windows.

[pure virtual] void QWindowsApplication::setAsyncExpose(bool value)

\internal

See also asyncExpose().

[pure virtual] void QWindowsApplication::setDarkModeHandling(DarkModeHandling handling)

\internal

Sets the dark mode handling to handling.

See also darkModeHandling().

[pure virtual] void QWindowsApplication::setTouchWindowTouchType(TouchWindowTouchTypes type)

\internal

Sets the touch window type for all windows to type.

See also touchWindowTouchType().

[pure virtual] bool QWindowsApplication::setWinTabEnabled(bool enabled)

\internal

Sets whether the Tablet WinTab Driver (Wintab32.dll) should be used to enabled.

Returns true on success, false otherwise.

See also isWinTabEnabled().

[pure virtual] void QWindowsApplication::setWindowActivationBehavior(WindowActivationBehavior behavior)

\internal

Sets the window activation behavior to behavior.

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

[pure virtual] TouchWindowTouchTypes QWindowsApplication::touchWindowTouchType() const

\internal

Returns the currently set the touch window type.

See also setTouchWindowTouchType().

[pure virtual] void QWindowsApplication::unregisterMime(QWindowsMimeConverter *mime)

\internal

Unregisters the converter mime from the system.

See also QWindowsMimeConverter and registerMime().

[pure virtual] WindowActivationBehavior QWindowsApplication::windowActivationBehavior() const

\internal

Returns the currently set the window activation behavior.

See also setWindowActivationBehavior().