mirror of
https://bitbucket.org/smil3y/kdelibs.git
synced 2025-02-24 10:52:49 +00:00
92 lines
2.8 KiB
C++
92 lines
2.8 KiB
C++
/* This file is part of the KDE project
|
|
Copyright (C) 2008 Matthias Kretz <kretz@kde.org>
|
|
|
|
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 of the License, or (at your option) version 3.
|
|
|
|
This library 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
|
|
Library General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Library General Public License
|
|
along with this library; see the file COPYING.LIB. If not, write to
|
|
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
Boston, MA 02110-1301, USA.
|
|
|
|
*/
|
|
|
|
#ifndef KFADEWIDGETEFFECT_H
|
|
#define KFADEWIDGETEFFECT_H
|
|
|
|
#include <kdeui_export.h>
|
|
#include <QtGui/QWidget>
|
|
|
|
class KFadeWidgetEffectPrivate;
|
|
|
|
/** \class KFadeWidgetEffect kfadewidgeteffect.h KFadeWidgetEffect
|
|
* \brief Animates changes fading the new UI over the old look.
|
|
*
|
|
* This widget will put itself above the widget that will change and show a fading transition from
|
|
* the old to the new UI. It will delete itself after the animation is finished.
|
|
* Example:
|
|
* \code
|
|
* KFadeWidgetEffect *animation = new KFadeWidgetEffect(widgetThatWillChange);
|
|
* // do changes on widgetThatWillChange
|
|
* // ...
|
|
* animation->start();
|
|
* \endcode
|
|
*
|
|
* \note The widget that changes needs to have a parent widget. KFadeWidgetEffect does not work
|
|
* for toplevel widgets (windows).
|
|
*
|
|
* \author Matthias Kretz <kretz@kde.org>
|
|
* \since 4.1
|
|
*/
|
|
class KDEUI_EXPORT KFadeWidgetEffect : public QWidget
|
|
{
|
|
Q_OBJECT
|
|
Q_DECLARE_PRIVATE(KFadeWidgetEffect)
|
|
public:
|
|
/**
|
|
* Create the animation widget. Takes a snapshot of the \p destWidget to use as old image
|
|
* that gets faded out.
|
|
*
|
|
* \param destWidget The widget that will change and should fade to the new look.
|
|
*/
|
|
KFadeWidgetEffect(QWidget *destWidget);
|
|
|
|
/**
|
|
* Destructor.
|
|
*
|
|
* \warning KFadeWidgetEffect deletes itself after the animation is finished.
|
|
*/
|
|
~KFadeWidgetEffect();
|
|
|
|
/**
|
|
* Starts the animation.
|
|
*
|
|
* Call this function after all visual changes are done.
|
|
*
|
|
* \param duration The duration of the animation in milliseconds.
|
|
*/
|
|
void start(int duration = 250);
|
|
|
|
protected:
|
|
/**
|
|
* \internal
|
|
*/
|
|
void paintEvent(QPaintEvent *);
|
|
|
|
/**
|
|
* \internal
|
|
*/
|
|
KFadeWidgetEffectPrivate *const d_ptr;
|
|
|
|
private:
|
|
Q_PRIVATE_SLOT(d_func(), void finished())
|
|
};
|
|
|
|
#endif // KFADEWIDGETEFFECT_H
|