Qt 4.3: QX11Info Class Reference

|  | Home · All Classes · Main Classes · Grouped Classes · Modules · Functions |

# QX11Info Class Reference
[QtGui module]

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 ()
- 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().

### 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.