You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
k3b/src/k3bmediacontentsview.h

118 lines
3.0 KiB

/*
*
* $Id: k3bmediacontentsview.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_MEDIUM_CONTENTS_VIEW_H_
#define _K3B_MEDIUM_CONTENTS_VIEW_H_
#include "k3bcontentsview.h"
#include <k3bthememanager.h>
#include <k3bmedium.h>
class K3bThemedHeader;
/**
* Abstract class from which all cd views must be derived. The contents view automatically handles medium changes for
* the selected device and reloads the contents if a new usable medium is inserted or disables the controls if the
* medium is just ejected. For this to work the proper content types have to be set.
*
* TODO: how about giving this one a TDEActionCollection so it can handle the toolbar automatically
*/
class K3bMediaContentsView : public K3bContentsView
{
TQ_OBJECT
public:
virtual ~K3bMediaContentsView();
const K3bMedium& medium() const;
/**
* Equals medium().device()
*/
K3bDevice::Device* device() const;
/**
* \return A bitwise or of K3bMedium::ContentType which
* represents the content types that can be displayed by this
* medium view.
*/
int supportedMediumContent() const;
int supportedMediumTypes() const;
int supportedMediumStates() const;
public slots:
/**
* Does some internal stuff and calls reloadMedium.
* Normally there is no need to call this manually.
*/
void reload();
/**
* Has the same effect as reload( k3bappcore->mediaCache()->medium( dev ) );
*/
void reload( K3bDevice::Device* dev );
/**
* Has the same effect as setMedium( m ), reload()
*/
void reload( const K3bMedium& m );
/**
* Enable or disable auto reloading when a new medium is inserted.
* If enabled (the default) the view will be reloaded if a new usable
* (as determined by the supportedXXX methods) medium has been inserted
* into the current device.
*/
void setAutoReload( bool b );
/**
* Enable or disable the controls of this view.
* The default implementation simply disables the whole window
*/
virtual void enableInteraction( bool enable );
protected:
K3bMediaContentsView( bool withHeader,
int mediumContent,
int mediumTypes,
int mediumState,
TQWidget* parent = 0,
const char* name = 0 );
/**
* Changes the medium without reloading the contents.
* Do not use, use reload( const K3bMedium& ) instead.
*/
void setMedium( const K3bMedium& );
/**
* Called by reload. Reimplement to actually display
* the contents of the medium.
*/
virtual void reloadMedium() = 0;
private slots:
void slotMediumChanged( K3bDevice::Device* );
private:
class Private;
Private* d;
};
#endif