Qt Reference Documentation

Contents

QX11Info Class Reference

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

 #include <QX11Info>

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.