Qt Reference Documentation

- Qt 4.8
- ALL VERSIONS

- A
- A
- A
- Print

# QX11Info Class Reference

The QX11Info class provides information about the X display configuration. More...

     #include <QX11Info>

- List of all members, including inherited members

## Public Functions

| QX11Info ()
| QX11Info ( const QX11Info & other )
| ~QX11Info ()
int | cells () const
Qt::HANDLE | colormap () const
bool | defaultColormap () const
bool | defaultVisual () const
int | depth () const
int | screen () const
void * | visual () const
QX11Info & | operator= ( const QX11Info & other )

## Static Public Members

int | appCells ( int screen = -1 )
const char * | appClass ()
Qt::HANDLE | appColormap ( int screen = -1 )
bool | appDefaultColormap ( int screen = -1 )
bool | appDefaultVisual ( int screen = -1 )
int | appDepth ( int screen = -1 )
int | appDpiX ( int screen = -1 )
int | appDpiY ( int screen = -1 )
Qt::HANDLE | appRootWindow ( int screen = -1 )
int | appScreen ()
unsigned long | appTime ()
unsigned long | appUserTime ()
void * | appVisual ( int screen = -1 )
Display * | display ()
bool | isCompositingManagerRunning ()
void | setAppDpiX ( int screen, int xdpi )
void | setAppDpiY ( int screen, int ydpi )
void | setAppTime ( unsigned long time )
void | setAppUserTime ( unsigned long time )

## Detailed Description

The QX11Info 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, use QDesktopWidget.

See also QWidget::x11Info(), QPixmap::x11Info(), and QDesktopWidget.

## Member Function Documentation

### QX11Info::QX11Info ()

Constructs an empty QX11Info object.

### QX11Info::QX11Info ( const QX11Info & other )

Constructs a copy of other.

### QX11Info::~QX11Info ()

Destroys the QX11Info object.

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

Returns the number of cells used by the application on the given screen.

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

See also cells().

### const char * QX11Info::appClass ()`[static]`

Returns the X11 application class.

See also display().

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

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

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

See also colormap() and defaultColormap().

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

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

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

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

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

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

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

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

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

See also depth().

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

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

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

See also setAppDpiX() and appDpiY().

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

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

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

See also setAppDpiY() and appDpiX().

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

Returns a handle for the applications root window on the given screen.

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

See also QApplication::desktop().

### int QX11Info::appScreen ()`[static]`

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

See also display() and screen().

### unsigned long QX11Info::appTime ()`[static]`

Returns the X11 time.

See also setAppTime() and appUserTime().

### unsigned long QX11Info::appUserTime ()`[static]`

Returns the X11 user time.

See also setAppUserTime() and appTime().

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

Returns the current visual used by the application on the given screen.

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

See also visual() and defaultVisual().

### int QX11Info::cells () const

Returns the number of cells.

See also appCells().

### Qt::HANDLE QX11Info::colormap () const

Returns a handle for the color map.

See also defaultColormap().

### bool QX11Info::defaultColormap () const

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

See also colormap().

### bool QX11Info::defaultVisual () const

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

See also visual() and appVisual().

### int QX11Info::depth () const

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

See also appDepth().

### Display * QX11Info::display ()`[static]`

Returns the default display for the application.

See also appScreen().

### bool QX11Info::isCompositingManagerRunning ()`[static]`

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. Use QDesktopWidget to query for information about Xinerama screens.

See also appScreen().

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

Sets the horizontal resolution of the given screen to the number of dots per inch specified by xdpi.

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

See also appDpiX() and setAppDpiY().

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

Sets the vertical resolution of the given screen to the number of dots per inch specified by ydpi.

The screen 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. Use QDesktopWidget to query for information about Xinerama screens.

See also appDpiY() and setAppDpiX().

### void QX11Info::setAppTime ( unsigned long time )`[static]`

Sets the X11 time to the value specified by time.

See also appTime() and setAppUserTime().

### void QX11Info::setAppUserTime ( unsigned long time )`[static]`

Sets the X11 user time as specified by time.

See also appUserTime() and setAppTime().

### void * QX11Info::visual () const

Returns the current visual.

See also appVisual() and defaultVisual().

### QX11Info & QX11Info::operator= ( const QX11Info & other )

Assigns other to this object and returns a reference to this object.