Contents

• Public Functions
• Static Public Members
• Detailed Description

Detailed Description

TheQX11Info class provides information about the X display configuration.

The class provides two APIs: a set of non-static functions that provide information about a specific widget or pixmap, and a set of static functions that provide the default information for the application.

Warning: This class is only available on X11. For querying per-screen information in a portable way, useQDesktopWidget.

Member Function Documentation

QX11Info::QX11Info()

Constructs an emptyQX11Info object.

QX11Info::QX11Info(constQX11Info & other)

Constructs a copy ofother.

QX11Info::~QX11Info()

Destroys theQX11Info object.

[static]int QX11Info::appCells(int screen = -1)

Returns the number of cells used by the application on the givenscreen.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

See alsocells().

[static]constchar * QX11Info::appClass()

Returns the X11 application class.

See alsodisplay().

[static]Qt::HANDLE QX11Info::appColormap(int screen = -1)

Returns a handle for the application's color map on the givenscreen.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

See alsocolormap() anddefaultColormap().

[static]bool QX11Info::appDefaultColormap(int screen = -1)

Returns true if the application has a default color map on the givenscreen; otherwise returns false.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

[static]bool QX11Info::appDefaultVisual(int screen = -1)

Returns true if the application has a default visual on the givenscreen; otherwise returns false.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

[static]int QX11Info::appDepth(int screen = -1)

Returns the color depth (bits per pixel) used by the application on the givenscreen.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

See alsodepth().

[static]int QX11Info::appDpiX(int screen = -1)

Returns the horizontal resolution of the givenscreen in terms of the number of dots per inch.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

See alsosetAppDpiX() andappDpiY().

[static]int QX11Info::appDpiY(int screen = -1)

Returns the vertical resolution of the givenscreen in terms of the number of dots per inch.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

See alsosetAppDpiY() andappDpiX().

[static]Qt::HANDLE QX11Info::appRootWindow(int screen = -1)

Returns a handle for the applications root window on the givenscreen.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

See alsoQApplication::desktop().

[static]int QX11Info::appScreen()

Returns the number of the screen where the application is being displayed.

See alsodisplay() andscreen().

[static]unsignedlong QX11Info::appTime()

Returns the X11 time.

See alsosetAppTime() andappUserTime().

[static]unsignedlong QX11Info::appUserTime()

Returns the X11 user time.

See alsosetAppUserTime() andappTime().

[static]void * QX11Info::appVisual(int screen = -1)

Returns the current visual used by the application on the givenscreen.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

See alsovisual() anddefaultVisual().

int QX11Info::cells() const

Returns the number of cells.

See alsoappCells().

Qt::HANDLE QX11Info::colormap() const

Returns a handle for the color map.

See alsodefaultColormap().

bool QX11Info::defaultColormap() const

Returns true if there is a default color map; otherwise returns false.

See alsocolormap().

bool QX11Info::defaultVisual() const

Returns true if there is a default visual; otherwise returns false.

See alsovisual() andappVisual().

int QX11Info::depth() const

Returns the color depth (bits per pixel) of the X display.

See alsoappDepth().

[static]Display * QX11Info::display()

Returns the default display for the application.

See alsoappScreen().

[static]bool QX11Info::isCompositingManagerRunning()

Returns true if there is a compositing manager running.

This function was introduced in Qt 4.4.

int QX11Info::screen() const

Returns the number of the screen currently in use.

The return value is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

See alsoappScreen().

[static]void QX11Info::setAppDpiX(int screen,int xdpi)

Sets the horizontal resolution of the givenscreen to the number of dots per inch specified byxdpi.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

See alsoappDpiX() andsetAppDpiY().

[static]void QX11Info::setAppDpiY(int screen,int ydpi)

Sets the vertical resolution of the givenscreen to the number of dots per inch specified byydpi.

Thescreen argument is an X screen number. Be aware that if the user's system uses Xinerama (as opposed to traditional X11 multiscreen), there is only one X screen. UseQDesktopWidget to query for information about Xinerama screens.

See alsoappDpiY() andsetAppDpiX().

[static]void QX11Info::setAppTime(unsignedlong time)

Sets the X11 time to the value specified bytime.

See alsoappTime() andsetAppUserTime().

[static]void QX11Info::setAppUserTime(unsignedlong time)

Sets the X11 user time as specified bytime.

See alsoappUserTime() andsetAppTime().

void * QX11Info::visual() const

Returns the current visual.

See alsoappVisual() anddefaultVisual().

QX11Info & QX11Info::operator=(constQX11Info & other)

Assignsother to this object and returns a reference to this object.