/usr/include/k3bthreadjob.h is in libk3b-dev 2.0.2-7ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 | /*
*
* Copyright (C) 2003-2010 Sebastian Trueg <trueg@k3b.org>
*
* This file is part of the K3b project.
* Copyright (C) 1998-2010 Sebastian Trueg <trueg@k3b.org>
*
* 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"
#include <climits>
namespace K3b {
class Thread;
/**
* A Job that runs in a different thread. Instead of reimplementing
* start() reimplement run() to perform all operations in a different
* thread. Otherwise usage is the same as Job.
*/
class LIBK3B_EXPORT ThreadJob : public Job
{
Q_OBJECT
public:
ThreadJob( JobHandler*, QObject* parent = 0 );
virtual ~ThreadJob();
/**
* \reimplemented from Job
*
* \return true if the job has been started and has not yet
* emitted the finished signal
*/
virtual bool active() const;
/**
* reimplemented from JobHandler
*/
virtual Device::MediaType waitForMedium( Device::Device*,
Device::MediaStates mediaState = Device::STATE_EMPTY,
Device::MediaTypes mediaType = Device::MEDIA_WRITABLE_CD,
const K3b::Msf& minMediaSize = K3b::Msf(),
const QString& message = QString() );
/**
* reimplemented from JobHandler
*/
virtual bool questionYesNo( const QString& text,
const QString& caption = QString(),
const KGuiItem& buttonYes = KStandardGuiItem::yes(),
const KGuiItem& buttonNo = KStandardGuiItem::no() );
/**
* reimplemented from JobHandler
*/
virtual void blockingInformation( const QString& text,
const QString& caption = QString() );
/**
* Call QThread::wait() on job's thread
* \see QThread::wait()
*/
bool wait( unsigned long time = ULONG_MAX );
public Q_SLOTS:
/**
* Starts the job in a different thread. Emits the started()
* signal.
*
* When reimplementing this method to perform housekeeping
* operations in the GUI thread make sure to call the
* parent implementation.
*
* \sa run()
*/
virtual void start();
/**
* Cancel the job. The method will give the thread a certain
* time to actually cancel. After that the thread is terminated.
*
* \sa canceled()
*/
virtual void cancel();
protected:
/**
* Implement this method to do the actual work in the thread.
* Do not emit started(), finished(), and canceled() signals
* in this method. ThreadJob will do that automatically.
*
* \return \p true on success.
*/
virtual bool run() = 0;
/**
* Use to check if the job has been canceled.
* \sa cancel()
*/
bool canceled() const;
private Q_SLOTS:
/**
* Called in the GUi thread once the job is done.
* Emits the finished signal and performs some
* housekeeping.
*/
void slotThreadFinished();
private:
void customEvent( QEvent* );
class Private;
Private* const d;
friend class Thread;
};
}
#endif
|