k3b/src/k3bmediaselectiondialog.h

/* 
 *
 * $Id: sourceheader 380067 2005-01-19 13:03:46Z trueg $
 * Copyright (C) 2005 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_MEDIA_SELECTION_DIALOG_H_
#define _K3B_MEDIA_SELECTION_DIALOG_H_

#include <kdialogbase.h>
#include <k3bmedium.h>

class K3bMediaSelectionComboBox;
namespace K3bDevice {
  class Device;
}

class K3bMediaSelectionDialog : public KDialogBase
{
  Q_OBJECT
  TQ_OBJECT

 public:
  /**
   * Do not use the constructor. Use the static method instead.
   */
  K3bMediaSelectionDialog( TQWidget* tqparent = 0, 
			   const TQString& title = TQString(), 
			   const TQString& text = TQString(), 
			   bool modal = false );
  ~K3bMediaSelectionDialog();

  /**
   * \see K3bMediaSelectionComboBox::setWantedMediumType()
   */
  void setWantedMediumType( int type );

  /**
   * \see K3bMediaSelectionComboBox::setWantedMediumState()
   */
  void setWantedMediumState( int state );

  /**
   * \see K3bMediaSelectionComboBox::setWantedMediumContent()
   */
  void setWantedMediumContent( int state );

  /**
   * Although the dialog is used to select a medium the result is the
   * device containing that medium.
   */
  K3bDevice::Device* selectedDevice() const;

  /**
   * \deprecated
   *
   * Select a medium.
   * If only one medium of the wanted type is found the method returns immideately
   * without showing the dialog.
   */
  static K3bDevice::Device* selectMedium( int type, int state, TQWidget* tqparent = 0,
					  const TQString& title = TQString(), 
					  const TQString& text = TQString(),
					  bool* canceled = 0 );

  static K3bDevice::Device* selectMedium( int type, int state, int content = K3bMedium::CONTENT_ALL,
					  TQWidget* tqparent = 0,
					  const TQString& title = TQString(), 
					  const TQString& text = TQString(),
					  bool* canceled = 0 );

 private slots:
  void slotSelectionChanged( K3bDevice::Device* );

 private:
  K3bMediaSelectionComboBox* m_combo;
};

#endif