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 VisualId
enum WmWindowType { Normal, Desktop, Dock, Toolbar, Menu, …, KdeOverride }

Static Public Members

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

Detailed Description

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

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

enum QXcbWindowFunctions::WmWindowType

This enum represents the supported WM_WINDOW_TYPE atoms.

ConstantValue
QXcbWindowFunctions::Normal0x000001
QXcbWindowFunctions::Desktop0x000002
QXcbWindowFunctions::Dock0x000004
QXcbWindowFunctions::Toolbar0x000008
QXcbWindowFunctions::Menu0x000010
QXcbWindowFunctions::Utility0x000020
QXcbWindowFunctions::Splash0x000040
QXcbWindowFunctions::Dialog0x000080
QXcbWindowFunctions::DropDownMenu0x000100
QXcbWindowFunctions::PopupMenu0x000200
QXcbWindowFunctions::Tooltip0x000400
QXcbWindowFunctions::Notification0x000800
QXcbWindowFunctions::Combo0x001000
QXcbWindowFunctions::Dnd0x002000
QXcbWindowFunctions::KdeOverride0x004000

Member Function Documentation

[static] void QXcbWindowFunctions::setWmWindowIconText(QWindow *window, const int &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 int 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 int &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 int 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 int QXcbWindowFunctions::setWmWindowTypeIdentifier()

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

[static] int 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 int QXcbWindowFunctions::visualIdIdentifier()

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