# class KAbstractWidgetJobTracker

### abstract

Module | kdeui
Namespace |
Class | KAbstractWidgetJobTracker
Inherits | KJobTrackerInterface

The base class for widget based job trackers.

### methods

- KAbstractWidgetJobTracker (parent)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  parent | QWidget | 0

  Creates a new KAbstractWidgetJobTracker

  parent - the parent of this object and of the widget displaying the job progresses

- autoDelete (job)

  returns bool

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  Checks whether the dialog should be deleted or cleaned.

  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()

- finished (job)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  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.

  job - the job that emitted this signal

- registerJob (job)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  Register a new job in this tracker. Note that job trackers inheriting from this class can have only one job registered at a time.

  job - the job to register

- resume (job)

  returns Nothing
  SIGNAL ("resume (KJob*)")

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  Emitted when the user resumed the operation

  job - The job that has been resumed

- setAutoDelete (job, autoDelete)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  job | KJob |
  autoDelete | bool |

  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.

  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()

- setStopOnClose (job, stopOnClose)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  job | KJob |
  stopOnClose | bool |

  This controls whether the job should be canceled if the dialog is closed.

  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()

- slotClean (job)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  This method is called when the widget should be cleaned (after job is finished). redefine this for custom behavior.

  job - The job that is being cleaned

- slotResume (job)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  This method should be called for pause/resume Connect this to the progress widgets buttons etc.

  job - The job that is being resumed

- slotStop (job)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  This method should be called for correct cancellation of IO operation Connect this to the progress widgets buttons etc.

  job - The job that is being stopped

- slotSuspend (job)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  This method should be called for pause/resume Connect this to the progress widgets buttons etc.

  job - The job that is being suspended

- stopOnClose (job)

  returns bool

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  Checks whether the job will be killed when the dialog is closed.

  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()

- stopped (job)

  returns Nothing
  SIGNAL ("stopped (KJob*)")

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  Emitted when the user aborted the operation

  job - The job that has been stopped

- suspend (job)

  returns Nothing
  SIGNAL ("suspend (KJob*)")

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  Emitted when the user suspended the operation

  job - The job that has been suspended

- unregisterJob (job)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  Unregister a job from this tracker.

  job - the job to unregister

- widget (job)

  returns QWidget
  pure virtual

  Argument | Type | Default
  --- | --- | ---
  job | KJob |

  The widget associated to this tracker.

  job - the job that is assigned the widget we want to return Returns the widget displaying the job progresses