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.
tdebase/libkonq/konq_propsview.h

186 lines
5.5 KiB

/* This file is part of the KDE project
Copyright (C) 1997 David Faure <faure@kde.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.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
#ifndef __konq_viewprops_h__
#define __konq_viewprops_h__
#include <tqpixmap.h>
#include <tqstringlist.h>
#include <kurl.h>
#include <libkonq_export.h>
class KInstance;
class KConfigBase;
class KConfig;
/**
* The class KonqPropsView holds the properties for a Konqueror View
*
* Separating them from the view class allows to store the default
* values (the one read from \<kinstance\>rc) in one instance of this class
* and to have another instance of this class in each view, storing the
* current values of the view.
*
* The local values can be read from a desktop entry, if any (.directory,
* bookmark, ...). [ .directory is implemented, bookmark isn't ].
*/
class LIBKONQ_EXPORT KonqPropsView
{
public:
/**
* Constructs a KonqPropsView instance from an instance config file.
* defaultProps is a "parent" object. If non null, then this instance
* is the one used by a view, and its value can differ from the default ones.
* The instance parameter should be the same for both...
*/
KonqPropsView( KInstance * instance, KonqPropsView * defaultProps /*= 0L*/ );
/** Destructor */
virtual ~KonqPropsView();
/**
* Is this the instance representing default properties ?
*/
bool isDefaultProperties() const {
// No parent -> we are the default properties
return m_defaultProps == 0L;
}
/**
* Called when entering a directory
* Checks for a .directory, read it.
* Don't do this on the default properties instance
* Returns TRUE if the settings for the new directories are
* different from the settings in the old directory.
*/
bool enterDir( const KURL & dir );
/**
* Turn on/off saving properties locally
* Don't do this on the default properties instance
*/
void setSaveViewPropertiesLocally( bool value );
///
void setIconSize( int size ); // in pixel, 0 for default
int iconSize() const { return m_iIconSize; }
void setItemTextPos( int pos ); // TQIconView::Bottom or TQIconView::Right, currently
int itemTextPos() const { return m_iItemTextPos; }
void setSortCriterion( const TQString &criterion );
const TQString& sortCriterion() const;
void setDirsFirst ( bool first );
bool isDirsFirst() const;
void setDescending (bool descending);
bool isDescending() const;
void setShowingDotFiles( bool show );
bool isShowingDotFiles() const { return m_bShowDot; }
void setCaseInsensitiveSort( bool show );
bool isCaseInsensitiveSort() const;
void setShowingDirectoryOverlays( bool show );
bool isShowingDirectoryOverlays() const { return m_bShowDirectoryOverlays; }
void setShowingPreview( const TQString &preview, bool show );
void setShowingPreview( bool show );
bool isShowingPreview( const TQString &preview ) const { return ! m_dontPreview.tqcontains(preview); }
bool isShowingPreview();
const TQStringList &previewSettings();
void setBgColor( const TQColor & color );
const TQColor& bgColor(TQWidget * widget) const;
void setTextColor( const TQColor & color );
const TQColor& textColor(TQWidget * widget) const;
void setBgPixmapFile( const TQString & file );
const TQString& bgPixmapFile() const { return m_bgPixmapFile; }
// Applies bgcolor, textcolor, pixmap to the @p widget
void applyColors( TQWidget * widget ) const;
protected:
TQPixmap loadPixmap() const;
// Current config object for _saving_
KConfigBase * currentConfig();
// Current config object for _saving_ settings related to colors
KConfigBase * currentColorConfig();
TQString currentGroup() const {
return isDefaultProperties() ?
TQString::tqfromLatin1("Settings") : TQString::tqfromLatin1("URL properties");
}
private:
// The actual properties
int m_iIconSize;
int m_iItemTextPos;
bool m_bShowDot;
bool m_bShowDirectoryOverlays;
TQStringList m_dontPreview;
TQColor m_textColor;
TQColor m_bgColor;
TQString m_bgPixmapFile;
// Path to .directory file, whether it exists or not
TQString dotDirectory;
bool m_bSaveViewPropertiesLocally;
// True if we found a .directory file to read
bool m_dotDirExists;
// Points to the current .directory file if we are in
// save-view-properties-locally mode, otherwise to the global config
// It is set to 0L to mark it as "needs to be constructed".
// This is to be used for SAVING only.
// Can be a KConfig or a KSimpleConfig
KConfigBase * m_currentConfig;
// If this is not a "default properties" instance (but one used by a view)
// then m_defaultProps points to the "default properties" instance
// Otherwise it's 0L.
KonqPropsView * m_defaultProps;
/**
* Private data for KonqPropsView
* Implementation in konq_propsview.cc
*/
struct Private;
Private *d;
private:
KonqPropsView( const KonqPropsView & );
KonqPropsView();
};
#endif