/* * * $Id: k3bthreadjob.h 619556 2007-01-03 17:38:12Z trueg $ * Copyright (C) 2003 Sebastian Trueg * * This file is part of the K3b project. * Copyright (C) 1998-2007 Sebastian Trueg * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * See the file "COPYING" for the exact licensing terms. */ #ifndef _K3B_THREAD_JOB_H_ #define _K3B_THREAD_JOB_H_ #include "k3bjob.h" #include "k3b_export.h" class TQCustomEvent; class K3bThread; /** * A Wrapper to use a K3bThread just like a K3bJob. * Usage: *
 *   K3bThread* thread = new MySuperThread(...);
 *   K3bThreadJob* job = new K3bThreadJob( thread, ... );
 *   K3bBurnProgressDialog d;
 *   d.setJob(job);
 *   job->start();
 *   d.exec();
 *   delete job;
 * 
* Be aware that K3bThreadJob'd destructor does NOT delete the thread. */ class LIBK3B_EXPORT K3bThreadJob : public K3bJob { Q_OBJECT TQ_OBJECT public: K3bThreadJob( K3bJobHandler*, TQObject* tqparent = 0, const char* name = 0 ); K3bThreadJob( K3bThread*, K3bJobHandler*, TQObject* tqparent = 0, const char* name = 0 ); virtual ~K3bThreadJob(); void setThread( K3bThread* t ); K3bThread* thread() const { return m_thread; } /** * \reimplemented from K3bJob * * \return true if the job has been started and has not yet * emitted the finished signal */ virtual bool active() const { return m_running; } virtual TQString jobDescription() const; virtual TQString jobDetails() const; public slots: virtual void start(); virtual void cancel(); protected: /** * converts K3bThread events to K3bJob signals */ virtual void customEvent( TQCustomEvent* ); /** * Reimplement this method to do some housekeeping once * the thread has finished. * * The default implementation does nothing. * * \param success True if the thread finished successfully */ virtual void cleanupJob( bool success ); private: K3bThread* m_thread; bool m_running; }; #endif