KAbstractWidgetJobTracker
#include <KAbstractWidgetJobTracker>
Signals | |
void | resume (KJob *job) |
void | stopped (KJob *job) |
void | suspend (KJob *job) |
Public Slots | |
void | registerJob (KJob *job) override |
void | unregisterJob (KJob *job) override |
Public Slots inherited from KJobTrackerInterface | |
virtual void | registerJob (KJob *job) |
virtual void | unregisterJob (KJob *job) |
Protected Slots | |
void | finished (KJob *job) override |
virtual void | slotClean (KJob *job) |
virtual void | slotResume (KJob *job) |
virtual void | slotStop (KJob *job) |
virtual void | slotSuspend (KJob *job) |
Protected Slots inherited from KJobTrackerInterface | |
virtual void | description (KJob *job, const QString &title, const QPair< QString, QString > &field1, const QPair< QString, QString > &field2) |
virtual void | finished (KJob *job) |
virtual void | infoMessage (KJob *job, const QString &message) |
virtual void | percent (KJob *job, unsigned long percent) |
virtual void | processedAmount (KJob *job, KJob::Unit unit, qulonglong amount) |
virtual void | resumed (KJob *job) |
virtual void | speed (KJob *job, unsigned long value) |
virtual void | suspended (KJob *job) |
virtual void | totalAmount (KJob *job, KJob::Unit unit, qulonglong amount) |
virtual void | warning (KJob *job, const QString &message) |
Protected Member Functions | |
KJOBWIDGETS_NO_EXPORT | KAbstractWidgetJobTracker (KAbstractWidgetJobTrackerPrivate &dd, QWidget *parent=nullptr) |
Protected Member Functions inherited from QObject | |
virtual void | childEvent (QChildEvent *event) |
virtual void | connectNotify (const QMetaMethod &signal) |
virtual void | customEvent (QEvent *event) |
virtual void | disconnectNotify (const QMetaMethod &signal) |
bool | isSignalConnected (const QMetaMethod &signal) const const |
int | receivers (const char *signal) const const |
QObject * | sender () const const |
int | senderSignalIndex () const const |
virtual void | timerEvent (QTimerEvent *event) |
Protected Attributes | |
std::unique_ptr< KAbstractWidgetJobTrackerPrivate > const | d_ptr |
Detailed Description
The base class for widget based job trackers.
Definition at line 27 of file kabstractwidgetjobtracker.h.
Constructor & Destructor Documentation
◆ KAbstractWidgetJobTracker() [1/2]
Creates a new KAbstractWidgetJobTracker.
- Parameters
-
parent the parent of this object and of the widget displaying the job progresses
Definition at line 15 of file kabstractwidgetjobtracker.cpp.
◆ ~KAbstractWidgetJobTracker()
|
overridedefault |
Destroys a KAbstractWidgetJobTracker.
◆ KAbstractWidgetJobTracker() [2/2]
|
explicitprotected |
Definition at line 20 of file kabstractwidgetjobtracker.cpp.
Member Function Documentation
◆ autoDelete()
bool KAbstractWidgetJobTracker::autoDelete | ( | KJob * | job | ) | const |
Checks whether the dialog should be deleted or cleaned.
- Parameters
-
job the job's widget that will be auto-deleted
- Returns
- false if the dialog only calls slotClean, true if it will be deleted
- See also
- setAutoDelete()
Definition at line 59 of file kabstractwidgetjobtracker.cpp.
◆ finished
Called when a job is finished, in any case.
It is used to notify that the job is terminated and that progress UI (if any) can be hidden.
- Parameters
-
job the job that emitted this signal
Definition at line 66 of file kabstractwidgetjobtracker.cpp.
◆ registerJob
Register a new job in this tracker.
Note that job trackers inheriting from this class can have only one job registered at a time.
- Parameters
-
job the job to register
Definition at line 28 of file kabstractwidgetjobtracker.cpp.
◆ resume
Emitted when the user resumed the operation.
- Parameters
-
job The job that has been resumed
◆ setAutoDelete()
This controls whether the dialog should be deleted or only cleaned when the KJob is finished (or canceled).
If your dialog is an embedded widget and not a separate window, you should setAutoDelete(false) in the constructor of your custom dialog.
- Parameters
-
job the job's widget that is going to be auto-deleted autoDelete If false the dialog will only call method slotClean. If true the dialog will be deleted.
- See also
- autoDelete()
Definition at line 52 of file kabstractwidgetjobtracker.cpp.
◆ setStopOnClose()
This controls whether the job should be canceled if the dialog is closed.
- Parameters
-
job the job's widget that will be stopped when closing stopOnClose If true the job will be stopped if the dialog is closed, otherwise the job will continue even on close.
- See also
- stopOnClose()
Definition at line 38 of file kabstractwidgetjobtracker.cpp.
◆ slotClean
This method is called when the widget should be cleaned (after job is finished).
redefine this for custom behavior.
- Parameters
-
job The job that is being cleaned
Definition at line 95 of file kabstractwidgetjobtracker.cpp.
◆ slotResume
This method should be called for pause/resume Connect this to the progress widgets buttons etc.
- Parameters
-
job The job that is being resumed
Definition at line 87 of file kabstractwidgetjobtracker.cpp.
◆ slotStop
This method should be called for correct cancellation of IO operation Connect this to the progress widgets buttons etc.
- Parameters
-
job The job that is being stopped
Definition at line 71 of file kabstractwidgetjobtracker.cpp.
◆ slotSuspend
This method should be called for pause/resume Connect this to the progress widgets buttons etc.
- Parameters
-
job The job that is being suspended
Definition at line 79 of file kabstractwidgetjobtracker.cpp.
◆ stopOnClose()
bool KAbstractWidgetJobTracker::stopOnClose | ( | KJob * | job | ) | const |
Checks whether the job will be killed when the dialog is closed.
- Parameters
-
job the job's widget that will be stopped when closing
- Returns
- true if the job is killed on close event, false otherwise.
- See also
- setStopOnClose()
Definition at line 45 of file kabstractwidgetjobtracker.cpp.
◆ stopped
Emitted when the user aborted the operation.
- Parameters
-
job The job that has been stopped
◆ suspend
Emitted when the user suspended the operation.
- Parameters
-
job The job that has been suspended
◆ unregisterJob
Unregister a job from this tracker.
- Parameters
-
job the job to unregister
Definition at line 33 of file kabstractwidgetjobtracker.cpp.
◆ widget()
The widget associated to this tracker.
- Parameters
-
job the job that is assigned the widget we want to return
- Returns
- the widget displaying the job progresses
Implemented in KStatusBarJobTracker, and KWidgetJobTracker.
Member Data Documentation
◆ d_ptr
|
protected |
Definition at line 181 of file kabstractwidgetjobtracker.h.
The documentation for this class was generated from the following files:
Documentation copyright © 1996-2024 The KDE developers.
Generated on Tue Mar 26 2024 11:13:04 by doxygen 1.10.0 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.