/* * Copyright 2007 by Dan Meltzer * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU Library General Public License as * published by the Free Software Foundation; either version 2, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details * * You should have received a copy of the GNU Library General Public * License along with this program; if not, write to the * Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ #include "tooltip_p.h" #include #include #include #include #include #include #include #ifdef Q_WS_X11 #include #endif #include #include #include #include #include #ifdef Q_WS_X11 #include #include #endif #include "plasma/plasma.h" namespace Plasma { class ToolTip::Private { public: Private() : label(0) , imageLabel(0) , preview(0) , windowToPreview(0) , currentWidget(0) , isShown(false) , delayedHide(false) , showTimer(0) , hideTimer(0) { } QLabel *label; QLabel *imageLabel; WindowPreview *preview; WId windowToPreview; Plasma::Widget *currentWidget; bool isShown; bool delayedHide; QTimer *showTimer; QTimer *hideTimer; PanelSvg *background; }; class ToolTipSingleton { public: ToolTip self; }; K_GLOBAL_STATIC( ToolTipSingleton, privateInstance ) ToolTip *ToolTip::self() { return &privateInstance->self; } void ToolTip::show(Plasma::Widget *widget) { d->hideTimer->stop(); d->delayedHide = false; if (d->isShown && d->currentWidget) { // we let know widget which had tooltip up to now that it's tooltip // is not longer displayed d->currentWidget->updateToolTip(false); } d->currentWidget = widget; d->showTimer->stop(); if (d->isShown) { // small delay to prevent unecessary showing when the mouse is moving quickly across items // which can be too much for less powerful CPUs to keep up with d->showTimer->start(200); } else { d->showTimer->start(500); } } void ToolTip::delayedHide() { d->showTimer->stop(); // stop the timer to show the tooltip d->delayedHide = true; d->hideTimer->start(250); } void ToolTip::hide() { d->currentWidget = 0; d->showTimer->stop(); //Mouse out, stop the timer to show the tooltip d->delayedHide = false; setVisible(false); d->hideTimer->start(250); //250 ms delay before we are officially "gone" to allow for the time to move between widgets } Plasma::Widget *ToolTip::currentWidget() const { return d->currentWidget; } //PRIVATE FUNCTIONS void ToolTip::showToolTip() { if (!d->currentWidget || !d->currentWidget->toolTip()) { return; } QGraphicsView *v = d->currentWidget->view(); if (v && v->mouseGrabber()) { return; } d->currentWidget->updateToolTip(true); setData(*d->currentWidget->toolTip()); if( d->windowToPreview != 0 ) { // show/hide the preview area d->preview->show(); } else { d->preview->hide(); } layout()->activate(); resize(sizeHint()); move(d->currentWidget->popupPosition(size())); if (isVisible()) { d->preview->setInfo(); } else { setVisible(true); } d->isShown = true; //ToolTip is visible } void ToolTip::resetShownState() { if (!isVisible() || //One might have moused out and back in again d->delayedHide) { d->delayedHide = false; d->isShown = false; setVisible(false); if (d->currentWidget) { d->currentWidget->updateToolTip(false); } d->currentWidget = 0; } } void ToolTip::showEvent(QShowEvent *e) { QWidget::showEvent(e); d->preview->setInfo(); } void ToolTip::mouseReleaseEvent(QMouseEvent* event) { if (rect().contains(event->pos())) { hide(); } } ToolTip::ToolTip() : QWidget(0) , d( new Private ) { setWindowFlags(Qt::ToolTip); QGridLayout *l = new QGridLayout; d->preview = new WindowPreview; d->label = new QLabel; d->label->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Minimum); d->label->setWordWrap(true); d->imageLabel = new QLabel; d->imageLabel->setAlignment(Qt::AlignTop | Qt::AlignLeft); d->background = new PanelSvg("widgets/tooltip", this); d->background->setBorderFlags(PanelSvg::DrawAllBorders); connect(d->background, SIGNAL(repaintNeeded()), this, SLOT(update())); l->addWidget(d->preview, 0, 0, 1, 2); l->addWidget(d->imageLabel, 1, 0); l->addWidget(d->label, 1, 1); setLayout(l); d->showTimer = new QTimer(this); d->showTimer->setSingleShot(true); d->hideTimer = new QTimer(this); d->hideTimer->setSingleShot(true); connect(d->showTimer, SIGNAL(timeout()), SLOT(showToolTip())); connect(d->hideTimer, SIGNAL(timeout()), SLOT(resetShownState())); connect(Plasma::Theme::self(), SIGNAL(themeChanged()), this, SLOT(themeUpdated())); themeUpdated(); } ToolTip::~ToolTip() { delete d; } void ToolTip::setData(Plasma::Widget *widget, const Plasma::ToolTipData &data) { if (d->currentWidget && d->currentWidget == widget) { setData(data); } } void ToolTip::setData(const Plasma::ToolTipData &data) { //reset our size d->label->setText("" + data.mainText + "
" + data.subText + "
"); d->imageLabel->setPixmap(data.image); d->windowToPreview = data.windowToPreview; d->preview->setWindowId( d->windowToPreview ); if (isVisible()) { resize(sizeHint()); if (d->currentWidget) { move(d->currentWidget->popupPosition(size())); } } } void ToolTip::themeUpdated() { const int topHeight = d->background->marginSize(Plasma::TopMargin); const int leftWidth = d->background->marginSize(Plasma::LeftMargin); const int rightWidth = d->background->marginSize(Plasma::RightMargin); const int bottomHeight = d->background->marginSize(Plasma::BottomMargin); setContentsMargins(leftWidth, topHeight, rightWidth, bottomHeight); // Make the tooltip use Plasma's colorscheme QPalette plasmaPalette = QPalette(); plasmaPalette.setColor(QPalette::Window, Plasma::Theme::self()->backgroundColor()); plasmaPalette.setColor(QPalette::WindowText, Plasma::Theme::self()->textColor()); setAutoFillBackground(true); setPalette(plasmaPalette); } // A widget which reserves area for window preview and sets hints on the toplevel // tooltip widget that tells KWin to render the preview in this area. This depends // on KWin's TaskbarThumbnail compositing effect (which is here detected). void WindowPreview::setWindowId(WId w) { if (!previewsAvailable()) { id = 0; return; } id = w; readWindowSize(); } bool WindowPreview::previewsAvailable() const { if (!KWindowSystem::compositingActive()) { return false; } #ifdef Q_WS_X11 // hackish way to find out if KWin has the effect enabled, // TODO provide proper support Display* dpy = QX11Info::display(); Atom atom = XInternAtom(dpy, "_KDE_WINDOW_PREVIEW", False); int cnt; Atom* list = XListProperties(dpy, DefaultRootWindow( dpy ), &cnt); if (list != NULL) { bool ret = ( qFind(list, list + cnt, atom) != list + cnt ); XFree(list); return ret; } #endif return false; } QSize WindowPreview::sizeHint() const { if (id == 0) { return QSize(); } if (!windowSize.isValid()) { readWindowSize(); } QSize s = windowSize; s.scale(200, 150, Qt::KeepAspectRatio); return s; } void WindowPreview::readWindowSize() const { #ifdef Q_WS_X11 Window r; int x, y; unsigned int w, h, b, d; if (XGetGeometry(QX11Info::display(), id, &r, &x, &y, &w, &h, &b, &d)) { windowSize = QSize( w, h ); } else { windowSize = QSize(); } #else windowSize = QSize(); #endif } void WindowPreview::setInfo() { #ifdef Q_WS_X11 Display *dpy = QX11Info::display(); Atom atom = XInternAtom(dpy, "_KDE_WINDOW_PREVIEW", False); if (id == 0) { XDeleteProperty(dpy, parentWidget()->winId(), atom); return; } if (!windowSize.isValid()) { readWindowSize(); } if (!windowSize.isValid()) { XDeleteProperty(dpy, parentWidget()->winId(), atom); return; } Q_ASSERT( parentWidget()->isWindow()); // parent must be toplevel long data[] = { 1, 5, id, x(), y(), width(), height() }; XChangeProperty(dpy, parentWidget()->winId(), atom, atom, 32, PropModeReplace, reinterpret_cast< unsigned char* >( data ), sizeof( data ) / sizeof( data[ 0 ] )); #endif } void ToolTip::resizeEvent(QResizeEvent *e) { QWidget::resizeEvent(e); d->background->resize(size()); setMask(d->background->mask()); } void ToolTip::paintEvent(QPaintEvent *e) { QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); painter.setClipRect(e->rect()); painter.setCompositionMode(QPainter::CompositionMode_Source ); painter.fillRect(rect(), Qt::transparent); d->background->paint(&painter, rect()); } } #include "tooltip_p.moc"