k3b/src/k3bwritingmodewidget.h

/* 
 *
 * $Id: k3bwritingmodewidget.h 619556 2007-01-03 17:38:12Z trueg $
 * Copyright (C) 2003 Sebastian Trueg <trueg@k3b.org>
 *
 * This file is part of the K3b project.
 * Copyright (C) 1998-2007 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_WRITING_MODE_WIDGET_H_
#define _K3B_WRITING_MODE_WIDGET_H_

#include <k3bintmapcombobox.h>

#include <k3bmedium.h>

class KConfigBase;


/**
 * Allows selection of K3b::WritingMode
 */
class K3bWritingModeWidget : public K3bIntMapComboBox
{
  Q_OBJECT
  TQ_OBJECT

 public:
  K3bWritingModeWidget( TQWidget* parent = 0, const char* name = 0 );
  K3bWritingModeWidget( int modes, TQWidget* parent = 0, const char* name = 0 );
  ~K3bWritingModeWidget();

  int writingMode() const;

  void saveConfig( KConfigBase* );
  /**
   * This will not emit the writingModeChanged signal
   */
  void loadConfig( KConfigBase* );

 public slots:
  /**
   * This will not emit the writingModeChanged signal
   */
  void setWritingMode( int m );
  void setSupportedModes( int );

  /**
   * If the device is set the supported writing modes
   * will be filtered by the ones supported by the drive.
   */
  void setDevice( K3bDevice::Device* );

  /**
   * Set the writing modes which make sense with the provided medium.
   * This will also reset the device from the medium.
   *
   * \param m The medium. May even be non-writable or no medium at all
   *          in which case only the auto mode will be selected.
   *
   * \sa setDevice
   */
  void determineSupportedModesFromMedium( const K3bMedium& m );

  /**
   * Convinience method. Does the same as the one above.
   *
   * \param dev The device which contains the medium. May even be 0 in
   *            which case only the auto mode will be selected.
   */
  void determineSupportedModesFromMedium( K3bDevice::Device* dev );

 signals:
  void writingModeChanged( int );

 private:
  void init();
  void updateModes();
  void initWhatsThisHelp();

  class Private;
  Private* d;
};

#endif