QXcbWindowFunctions Class

The QXcbWindowFunctions class is an inline class containing miscellaneous functionality for xcb window specific functionality. More...

Header: #include <QXcbWindowFunctions>

Public Types

typedef SetWmWindowIconText
typedef SetWmWindowRole
typedef SetWmWindowType
typedef VisualId
enum WmWindowType { Normal, Desktop, Dock, Toolbar, ..., KdeOverride }
flags WmWindowTypes

Static Public Members

void setWmWindowIconText(QWindow *window, const QString &text)
const QByteArray setWmWindowIconTextIdentifier()
void setWmWindowRole(QWindow *window, const QByteArray &role)
const QByteArray setWmWindowRoleIdentifier()
void setWmWindowType(QWindow *window, QXcbWindowFunctions::WmWindowType type)
const QByteArray setWmWindowTypeIdentifier()
uint visualId(QWindow *window)
const QByteArray visualIdIdentifier()

Detailed Description

The QXcbWindowFunctions class is an inline class containing miscellaneous functionality for xcb 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();

    QXcbWindowFunctions::setWmWindowType(tlwWindow, QXcbWindowFunctions::Dock);

    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 QXcbWindowFunctions::SetWmWindowIconText

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

typedef QXcbWindowFunctions::SetWmWindowRole

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

This typedef was introduced in Qt 5.6.2.

typedef QXcbWindowFunctions::SetWmWindowType

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

typedef QXcbWindowFunctions::VisualId

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

enum QXcbWindowFunctions::WmWindowTypeflags QXcbWindowFunctions::WmWindowTypes

This enum represents the supported WM_WINDOW_TYPE atoms.

Constant Value
QXcbWindowFunctions::Normal 0x000001
QXcbWindowFunctions::Desktop 0x000002
QXcbWindowFunctions::Dock 0x000004
QXcbWindowFunctions::Toolbar 0x000008
QXcbWindowFunctions::Menu 0x000010
QXcbWindowFunctions::Utility 0x000020
QXcbWindowFunctions::Splash 0x000040
QXcbWindowFunctions::Dialog 0x000080
QXcbWindowFunctions::DropDownMenu 0x000100
QXcbWindowFunctions::PopupMenu 0x000200
QXcbWindowFunctions::Tooltip 0x000400
QXcbWindowFunctions::Notification 0x000800
QXcbWindowFunctions::Combo 0x001000
QXcbWindowFunctions::Dnd 0x002000
QXcbWindowFunctions::KdeOverride 0x004000

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

Member Function Documentation

[static] void QXcbWindowFunctions::setWmWindowIconText(QWindow *window, const QString &text)

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

[static] const QByteArray QXcbWindowFunctions::setWmWindowIconTextIdentifier()

This function returns the byte array that can be used to query QGuiApplication::platformFunction to retrieve the SetWmWindowIconText function.

[static] void QXcbWindowFunctions::setWmWindowRole(QWindow *window, const QByteArray &role)

Sets the WM_WINDOW_ROLE property from role on the corresponding X11 window.

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

This function was introduced in Qt 5.6.2.

[static] const QByteArray QXcbWindowFunctions::setWmWindowRoleIdentifier()

This function returns the byte array that can be used to query QGuiApplication::platformFunction to retrieve the SetWmWindowRole function.

This function was introduced in Qt 5.6.2.

[static] void QXcbWindowFunctions::setWmWindowType(QWindow *window, QXcbWindowFunctions::WmWindowType 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 QXcbWindowFunctions::setWmWindowTypeIdentifier()

This function returns the byte array that can be used to query QGuiApplication::platformFunction to retrieve the SetWmWindowType function.

[static] uint QXcbWindowFunctions::visualId(QWindow *window)

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

Returns the unsigned integer result of calling the function or UINT_MAX if the function was not found.

[static] const QByteArray QXcbWindowFunctions::visualIdIdentifier()

This function returns the byte array that can be used to query QGuiApplication::platformFunction to retrieve the VisualId function.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qxcbwindowfunctions.html