You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
145 lines
3.9 KiB
145 lines
3.9 KiB
/* This file is part of the KDE libraries
|
|
Copyright (C) 2000 Kurt Granroth <granroth@kde.org>
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Library General Public
|
|
License version 2 as published by the Free Software Foundation.
|
|
|
|
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 _KANIMWIDGET_H
|
|
#define _KANIMWIDGET_H
|
|
|
|
#include <tqframe.h>
|
|
|
|
#include <kdelibs_export.h>
|
|
|
|
class TQStringList;
|
|
class TQPainter;
|
|
class TQMouseEvent;
|
|
|
|
class KAnimWidgetPrivate;
|
|
/**
|
|
* @short Standard "About KDE" dialog box
|
|
*
|
|
* This is a widget used to display animation using multiple
|
|
* individual pixmaps. This widget allows you to deal with variable
|
|
* size icons (e.g., ones that will change based on a global setting)
|
|
* as it loads the icons internally. All you need to do is pass along
|
|
* a list of icon names and their size and everything else is taken
|
|
* care of.
|
|
*
|
|
* This widget also emits a 'clicked()' signal when it received a
|
|
* mouse press event.
|
|
*
|
|
* A quick example:
|
|
* \code
|
|
* KAnimWidget *anim = new KAnimWidget("kde", 0, this);
|
|
* anim->start();
|
|
* \endcode
|
|
*
|
|
* That example will search for the pixmaps "one.png", "two.png", and
|
|
* "three.png" in the share/icons/small/ directories as well as the
|
|
* app's pics directory.
|
|
*
|
|
* @author Kurt Granroth <granroth@kde.org>
|
|
*/
|
|
class KDEUI_EXPORT KAnimWidget : public QFrame
|
|
{
|
|
Q_OBJECT
|
|
Q_PROPERTY( int size READ size WRITE setSize )
|
|
Q_PROPERTY( TQString icons READ icons WRITE setIcons )
|
|
|
|
public:
|
|
/**
|
|
* This is the most common constructor. Pass along the name of the
|
|
* animated icons to use (e.g., "kde") for the animation and an
|
|
* optional size to load and you're set. If you omit the size, the
|
|
* default size will be used.
|
|
*
|
|
* @param icons The icons name (e.g., "kde") to use for the animation
|
|
* @param size The size to load
|
|
* You don't have to set it if the parent is a
|
|
* KToolBar; in this case it will use the toolbar's
|
|
* size.
|
|
* @param parent The standard parent
|
|
* @param name The standard internal name
|
|
*/
|
|
KAnimWidget( const TQString& icons, int size = 0,
|
|
TQWidget *parent = 0L, const char *name = 0L );
|
|
|
|
/**
|
|
* Destructor
|
|
*/
|
|
virtual ~KAnimWidget();
|
|
|
|
/**
|
|
* Sets the size of the icons.
|
|
*
|
|
* @param size The size of the icons
|
|
*/
|
|
void setSize( int size );
|
|
|
|
/**
|
|
* Returns the current size.
|
|
* @since 3.4
|
|
*/
|
|
int size() const;
|
|
|
|
/**
|
|
* Returns the current icons
|
|
* since 3.4
|
|
*/
|
|
TQString icons() const;
|
|
|
|
/**
|
|
* Sets the name of the animated icons to load. This will use the
|
|
* KIconLoader::loadAnimated method for the actual loading.
|
|
*
|
|
* @param icons The name of the icons to use for the animation
|
|
*/
|
|
void setIcons( const TQString& icons );
|
|
|
|
public slots:
|
|
/**
|
|
* Starts the animation from frame 1
|
|
*/
|
|
void start();
|
|
|
|
/**
|
|
* Stops the animation. This will also reset the widget to frame 1.
|
|
*/
|
|
void stop();
|
|
|
|
signals:
|
|
void clicked();
|
|
|
|
protected:
|
|
virtual void drawContents( TQPainter *p );
|
|
virtual void leaveEvent( TQEvent *e );
|
|
virtual void enterEvent( TQEvent *e );
|
|
virtual void hideEvent( TQHideEvent *e);
|
|
virtual void showEvent( TQShowEvent *e);
|
|
virtual void mousePressEvent( TQMouseEvent *e );
|
|
virtual void mouseReleaseEvent( TQMouseEvent *e );
|
|
|
|
protected slots:
|
|
void slotTimerUpdate();
|
|
void updateIcons();
|
|
|
|
protected:
|
|
virtual void virtual_hook( int id, void* data );
|
|
private:
|
|
KAnimWidgetPrivate *d;
|
|
};
|
|
|
|
#endif // _KANIMWIDGET_H
|