QDesktopWidget Class Reference

#include <qdesktopwidget.h>

Inheritance diagram for QDesktopWidget:

[legend]Collaboration diagram for QDesktopWidget:

[legend]List of all members.

---

Detailed Description

Definition at line 36 of file qdesktopwidget.h.

Signals
void	resized (int)
void	workAreaResized (int)
Public Member Functions
	QDesktopWidget ()
	~QDesktopWidget ()
bool	isVirtualDesktop () const
int	numScreens () const
int	primaryScreen () const
int	screenNumber (const QWidget *widget=0) const
int	screenNumber (const QPoint &) const
QWidget *	screen (int screen=-1)
const QRect	screenGeometry (int screen=-1) const
const QRect	screenGeometry (const QWidget *widget) const
const QRect	screenGeometry (const QPoint &point) const
const QRect	availableGeometry (int screen=-1) const
const QRect	availableGeometry (const QWidget *widget) const
const QRect	availableGeometry (const QPoint &point) const
Protected Member Functions
void	resizeEvent (QResizeEvent *e)
Friends
class	QApplication

---

Constructor & Destructor Documentation

QDesktopWidget::QDesktopWidget

(

)

Definition at line 163 of file qdesktopwidget_x11.cpp.

References d.

    : QWidget(*new QDesktopWidgetPrivate, 0, Qt::Desktop)
{
    Q_D(QDesktopWidget);
    d->init();
}

QDesktopWidget::~QDesktopWidget

(

)

Definition at line 170 of file qdesktopwidget_x11.cpp.

{
}

---

Member Function Documentation

bool QDesktopWidget::isVirtualDesktop

(

)

const

Definition at line 174 of file qdesktopwidget_x11.cpp.

References d.

Referenced by availableGeometry().

{
    Q_D(const QDesktopWidget);
    return d->use_xinerama;
}

int QDesktopWidget::numScreens

(

)

const

Definition at line 186 of file qdesktopwidget_x11.cpp.

References d.

Referenced by QWidget::restoreGeometry().

{
    Q_D(const QDesktopWidget);
    return d->screenCount;
}

int QDesktopWidget::primaryScreen

(

)

const

Definition at line 180 of file qdesktopwidget_x11.cpp.

References d.

Referenced by QWidget::restoreGeometry().

{
    Q_D(const QDesktopWidget);
    return d->defaultScreen;
}

int QDesktopWidget::screenNumber

(

const QWidget *

widget = 0

)

const

Definition at line 270 of file qdesktopwidget_x11.cpp.

References d, QWidget::frameGeometry(), i, QWidget::isWindow(), QWidget::mapToGlobal(), QRect::moveTopLeft(), QWidget::size(), and QSize::width().

Referenced by QDialog::adjustPosition(), QDesignerWorkbench::availableGeometry(), QMenu::internalDelayedPopup(), main(), QWhatsThisPrivate::say(), and QToolTip::showText().

{
    Q_D(const QDesktopWidget);
    if (!widget)
        return d->defaultScreen;

#ifndef QT_NO_XINERAMA
    if (d->use_xinerama) {
        // this is how we do it for xinerama
        QRect frame = widget->frameGeometry();
        if (!widget->isWindow())
            frame.moveTopLeft(widget->mapToGlobal(QPoint(0, 0)));

        int maxSize = -1;
        int maxScreen = -1;

        for (int i = 0; i < d->screenCount; ++i) {
            QRect sect = d->rects[i].intersected(frame);
            int size = sect.width() * sect.height();
            if (size > maxSize && sect.width() > 0 && sect.height() > 0) {
                maxSize = size;
                maxScreen = i;
            }
        }
        return maxScreen;
    }
#endif // QT_NO_XINERAMA

    return widget->x11Info().screen();
}

Here is the call graph for this function:

int QDesktopWidget::screenNumber

(

const QPoint &

)

const

Definition at line 301 of file qdesktopwidget_x11.cpp.

References d, and i.

{
    Q_D(const QDesktopWidget);
    int closestScreen = -1;
    int shortestDistance = INT_MAX;
    for (int i = 0; i < d->screenCount; ++i) {
        int thisDistance = d->pointToRect(point, d->rects[i]);
        if (thisDistance < shortestDistance) {
            shortestDistance = thisDistance;
            closestScreen = i;
        }
    }
    return closestScreen;
}

QWidget * QDesktopWidget::screen

(

int

screen = -1

)

Definition at line 192 of file qdesktopwidget_x11.cpp.

References d, Qt::Desktop, and qt_x11_create_desktop_on_screen.

Referenced by find_trans_colors(), QWidget::mapFromGlobal(), qt_check_clipboard_sentinel(), and qt_check_selection_sentinel().

{
    Q_D(QDesktopWidget);
    if (d->use_xinerama)
        return this;

    if (screen < 0 || screen >= d->screenCount)
        screen = d->defaultScreen;

    if (! d->screens) {
        d->screens = new QWidget*[d->screenCount];
        memset(d->screens, 0, d->screenCount * sizeof(QWidget *));
        d->screens[d->defaultScreen] = this;
    }

    if (! d->screens[screen] ||               // not created yet
        ! (d->screens[screen]->windowType() == Qt::Desktop)) { // reparented away
        qt_x11_create_desktop_on_screen = screen;
        d->screens[screen] = new QSingleDesktopWidget;
        qt_x11_create_desktop_on_screen = -1;
    }

    return d->screens[screen];
}

const QRect QDesktopWidget::screenGeometry

(

int

screen = -1

)

const

Definition at line 261 of file qdesktopwidget_x11.cpp.

References d.

Referenced by QWidget::adjustSize(), availableGeometry(), QBalloonTip::balloon(), Q3FileDialog::init(), QMenuBarPrivate::popupAction(), QMenuPrivate::popupGeometry(), QComboBoxPrivate::popupGeometry(), QWhatsThisPrivate::say(), QToolTip::showText(), and QWindowsXPStylePrivate::tabBody().

{
    Q_D(const QDesktopWidget);
    if (screen < 0 || screen >= d->screenCount)
        screen = d->defaultScreen;

    return d->rects[screen];
}

const QRect QDesktopWidget::screenGeometry

(

const QWidget *

widget

)

const [inline]

Definition at line 54 of file qdesktopwidget.h.

    { return screenGeometry(screenNumber(widget)); }

const QRect QDesktopWidget::screenGeometry

(

const QPoint &

point

)

const [inline]

Definition at line 56 of file qdesktopwidget.h.

    { return screenGeometry(screenNumber(point)); }

const QRect QDesktopWidget::availableGeometry

(

int

screen = -1

)

const

Definition at line 217 of file qdesktopwidget_x11.cpp.

References QX11Info::appRootWindow(), ATOM, d, data, i, isVirtualDesktop(), qt_desktopwidget_workarea_dirty, qt_net_supports(), screenGeometry(), Success, and X11.

Referenced by QDialog::adjustPosition(), QDesignerWorkbench::availableGeometry(), QDateTimeEdit::mousePressEvent(), Oubliette::paintEvent(), Q3ComboBox::popup(), QMenuPrivate::popupGeometry(), QComboBoxPrivate::popupGeometry(), QWidget::restoreGeometry(), QDesignerSettings::setGeometryHelper(), QWidget::setWindowState(), QWidgetPrivate::show_sys(), QCompleterPrivate::showPopup(), QToolTip::showText(), QDesignerWorkbench::switchToNeutralMode(), QDesignerWorkbench::switchToTopLevelMode(), and QMessageBoxPrivate::updateSize().

{
    Q_D(const QDesktopWidget);
    if (qt_desktopwidget_workarea_dirty) {
        // the workareas are dirty, invalidate them
        for (int i = 0; i < d->screenCount; ++i)
            d->workareas[i] = QRect();
        qt_desktopwidget_workarea_dirty = false;
    }

    if (screen < 0 || screen >= d->screenCount)
        screen = d->defaultScreen;

    if (d->workareas[screen].isValid())
        return d->workareas[screen];

    if (! isVirtualDesktop() && qt_net_supports(ATOM(_NET_WORKAREA))) {
        Atom ret;
        int format, e;
        unsigned char *data = 0;
        unsigned long nitems, after;

        e = XGetWindowProperty(X11->display,
                                QX11Info::appRootWindow(screen),
                                ATOM(_NET_WORKAREA), 0, 4, False, XA_CARDINAL,
                                &ret, &format, &nitems, &after, &data);

        if (e == Success && ret == XA_CARDINAL &&
            format == 32 && nitems == 4) {
            long *workarea = (long *) data;
            d->workareas[screen].setRect(workarea[0], workarea[1],
                                          workarea[2], workarea[3]);
        } else {
            d->workareas[screen] = screenGeometry(screen);
        }
        if (data)
            XFree(data);
    } else {
        d->workareas[screen] = screenGeometry(screen);
    }

    return d->workareas[screen];
}

Here is the call graph for this function:

const QRect QDesktopWidget::availableGeometry

(

const QWidget *

widget

)

const [inline]

Definition at line 60 of file qdesktopwidget.h.

    { return availableGeometry(screenNumber(widget)); }

const QRect QDesktopWidget::availableGeometry

(

const QPoint &

point

)

const [inline]

Definition at line 62 of file qdesktopwidget.h.

    { return availableGeometry(screenNumber(point)); }

void QDesktopWidget::resized

(

int

)

[signal]

void QDesktopWidget::workAreaResized

(

int

)

[signal]

void QDesktopWidget::resizeEvent

(

QResizeEvent *

e

)

[protected, virtual]

This event handler can be reimplemented in a subclass to receive widget resize events which are passed in the event parameter. When resizeEvent() is called, the widget already has its new geometry. The old size is accessible through QResizeEvent::oldSize().

The widget will be erased and receive a paint event immediately after processing the resize event. No drawing need be (or should be) done inside this handler.

See also:

moveEvent(), event(), resize(), QResizeEvent, paintEvent(), {Scribble Example}

Reimplemented from QWidget.

Definition at line 316 of file qdesktopwidget_x11.cpp.

References d, QWidget::event(), qt_desktopwidget_workarea_dirty, and QWidget::resizeEvent().

{
    Q_D(QDesktopWidget);
    d->init();
    qt_desktopwidget_workarea_dirty = true;
    QWidget::resizeEvent(event);
}

Here is the call graph for this function:

---

Friends And Related Function Documentation

friend class QApplication [friend]

Reimplemented from QWidget.

Definition at line 76 of file qdesktopwidget.h.

---

The documentation for this class was generated from the following files:

• src/gui/kernel/qdesktopwidget.h
• src/gui/kernel/qdesktopwidget_x11.cpp

---