MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

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.

© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.

All other trademarks are property of their respective owners. Privacy Policy


Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.

Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.