File indexing completed on 2024-05-05 09:02:08

 /*
     SPDX-FileCopyrightText: 2004-2009 Sebastian Trueg <trueg@k3b.org>
     SPDX-FileCopyrightText: 1998-2009 Sebastian Trueg <trueg@k3b.org>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #ifndef _K3B_JOB_HANDLER_H_
 #define _K3B_JOB_HANDLER_H_
 
 
 #include "k3bdiskinfo.h"
 #include "k3bdevice.h"
 #include <KStandardGuiItem>
 
 
 namespace K3b {
     /**
      * See @p JobProgressDialog as an example for the usage of
      * the JobHandler interface.
      */
     class JobHandler
     {
     public:
         JobHandler() {}
         virtual ~JobHandler() {}
 
         /**
          * \return true if the handler itself is also a job
          */
         virtual bool isJob() const { return false; }
 
         /**
          * @return Device::MediaType on success,
          *         Device::MEDIA_UNKNOWN on error (canceled)
          */
         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() ) = 0;
 
         virtual bool questionYesNo( const QString& text,
                                     const QString& caption = QString(),
                                     const KGuiItem& buttonYes = KStandardGuiItem::ok(),
                                     const KGuiItem& buttonNo = KStandardGuiItem::cancel() ) = 0;
 
         /**
          * Use this if you need the user to do something before the job is able to continue.
          * In all other cases an infoMessage should be used.
          */
         virtual void blockingInformation( const QString& text,
                                           const QString& caption = QString() ) = 0;
 
     };
 }
 
 #endif