/usr/include/kjobuidelegate.h is in kdelibs5-dev 4:4.8.4-4+deb7u1.
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 135 136 137 138 | /* This file is part of the KDE libraries
Copyright (C) 2000 Stephan Kulow <coolo@kde.org>
David Faure <faure@kde.org>
Copyright (C) 2006 Kevin Ottens <ervin@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 as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
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 KJOBUIDELEGATE_H
#define KJOBUIDELEGATE_H
#include <kdecore_export.h>
#include <QtCore/QObject>
class KJob;
/**
* The base class for all KJob UI delegate.
*
* A UI delegate is responsible for the events of a
* job and provides a UI for them (an error message
* box or warning etc.).
*
* @see KJob
*/
class KDECORE_EXPORT KJobUiDelegate : public QObject
{
Q_OBJECT
public:
/**
* Constructs a new KJobUiDelegate.
*/
KJobUiDelegate();
/**
* Destroys a KJobUiDelegate.
*/
virtual ~KJobUiDelegate();
private:
/**
* Attach this UI delegate to a job. Once attached it'll track the job events.
*
* @return true if the job we're correctly attached to the job, false otherwise.
*/
bool setJob( KJob *job );
protected:
/**
* Retrieves the current job this UI delegate is attached to.
*
* @return current job this UI delegate is attached to, or 0 if
* this UI delegate is not tracking any job
*/
KJob *job();
friend class KJob;
public:
/**
* Display a dialog box to inform the user of the error given by
* this job.
* Only call if error is not 0, and only in the slot connected
* to result.
*/
virtual void showErrorMessage();
/**
* Enable or disable the automatic error handling. When automatic
* error handling is enabled and an error occurs, then showErrorDialog()
* is called, right before the emission of the result signal.
*
* The default is false.
*
* See also isAutoErrorHandlingEnabled , showErrorDialog
*
* @param enable enable or disable automatic error handling
* @see isAutoErrorHandlingEnabled()
*/
void setAutoErrorHandlingEnabled( bool enable );
/**
* Returns whether automatic error handling is enabled or disabled.
* See also setAutoErrorHandlingEnabled .
* @return true if automatic error handling is enabled
* @see setAutoErrorHandlingEnabled()
*/
bool isAutoErrorHandlingEnabled() const;
/**
* Enable or disable the automatic warning handling. When automatic
* warning handling is enabled and an error occurs, then a message box
* is displayed with the warning message
*
* The default is true.
*
* See also isAutoWarningHandlingEnabled , showErrorDialog
*
* @param enable enable or disable automatic warning handling
* @see isAutoWarningHandlingEnabled()
*/
void setAutoWarningHandlingEnabled( bool enable );
/**
* Returns whether automatic warning handling is enabled or disabled.
* See also setAutoWarningHandlingEnabled .
* @return true if automatic warning handling is enabled
* @see setAutoWarningHandlingEnabled()
*/
bool isAutoWarningHandlingEnabled() const;
protected Q_SLOTS:
virtual void slotWarning(KJob *job, const QString &plain, const QString &rich);
private:
void connectJob(KJob *job);
Q_PRIVATE_SLOT(d, void _k_result(KJob*))
class Private;
Private * const d;
};
#endif // KJOBUIDELEGATE_H
|