Source: khtml_settings.h

/* This file is part of the KDE project
   Copyright (C) 1999 David Faure 

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.

   This library 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
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.
*/

#ifndef __konq_htmlsettings_h__
#define __konq_htmlsettings_h__

class KConfig;
#include 
#include 
#include 
#include 
#include 

/**
 * Settings for the HTML view.
 */
class KHTMLSettings
{
public:

    /**
     * This enum specifies whether Java/JavaScript execution is allowed.
     */
    enum KJavaScriptAdvice {
	KJavaScriptDunno=0,
	KJavaScriptAccept,
	KJavaScriptReject
    };

    /**
     * @internal Constructor
     */
    KHTMLSettings();

    /** Called by constructor and reparseConfiguration */
    void init();

    /** Read settings from @p config.
     * @param reset if true, settings are always set; if false,
     *  settings are only set if the config file has a corresponding key.
     */
    void init( KConfig * config, bool reset = true );

    /** Destructor. Don't delete any instance by yourself. */
    virtual ~KHTMLSettings() {};

    // Behaviour settings
    bool changeCursor() { return m_bChangeCursor; }
    bool underlineLink() { return m_underlineLink; }
    bool hoverLink() { return m_hoverLink; }

    // Font settings
    QString stdFontName() const;
    QString fixedFontName() const;
    QString serifFontName() const;
    QString sansSerifFontName() const;
    QString cursiveFontName() const;
    QString fantasyFontName() const;

    // these two can be set. Mainly for historical reasons (the method in KHTMLPart exists...)
    void setStdFontName(const QString &n);
    void setFixedFontName(const QString &n);

    const QValueList &fontSizes() const { return m_fontSizes; }
    void setFontSizes(const QValueList &newFontSizes );
    void resetFontSizes();

    int minFontSize() const { return m_minFontSize; }

    // the charset used to display the current document.
    QFont::CharSet charset() const { return m_charset; }
    void setCharset( QFont::CharSet c );
    QFont::CharSet script() const { return m_script; }
    void setScript( QFont::CharSet c );
    void resetCharset( );

    void setDefaultCharset( QFont::CharSet c, bool b );

    const QString &encoding() const { return m_encoding; }

    // Color settings
    const QColor& textColor() { return m_textColor; }
    const QColor& linkColor() { return m_linkColor; }
    const QColor& vLinkColor() { return m_vLinkColor; }

    // Autoload images
    bool autoLoadImages() { return m_bAutoLoadImages; }

    // Java and JavaScript
    bool isJavaEnabled( const QString& hostname = QString::null );
    bool isJavaScriptEnabled( const QString& hostname = QString::null );
    bool isPluginsEnabled( const QString& hostname = QString::null );
    bool isCSSEnabled( const QString& hostname = QString::null );

    // helpers for parsing domain-specific configuration, used in KControl module as well
    static KJavaScriptAdvice strToAdvice(const QString& _str);
    static void splitDomainAdvice(const QString& configStr, QString &domain,
				  KJavaScriptAdvice &javaAdvice, KJavaScriptAdvice& javaScriptAdvice);
    static const char* adviceToStr(KJavaScriptAdvice _advice);

    QString settingsToCSS() const;
    QString availableFamilies() const { return availFamilies; }

    QString userStyleSheet() const;

    // Form completion
    bool isFormCompletionEnabled() const { return m_formCompletionEnabled; }
    int maxFormCompletionItems() const { return m_maxFormCompletionItems; }

private:
    void setFont(const QFont::CharSet &charset, int i, const QString &n);
    QString lookupFont(const QFont::CharSet &charset, int i) const;

    void internalSetCharset( QFont::CharSet c );
    
private:
    bool m_bChangeCursor;
    bool m_underlineLink;
    bool m_hoverLink;

    int m_fontSize;
    QValueList     m_fontSizes;
    int m_minFontSize;

    QFont::CharSet m_charset;
    QFont::CharSet m_script;
    QFont::CharSet m_defaultCharset;
    bool enforceCharset;
    QString m_encoding;
    QString m_userSheet;
    
    QColor m_textColor;
    QColor m_linkColor;
    QColor m_vLinkColor;

    bool m_bAutoLoadImages;
    bool m_bEnableJava;
    bool m_bEnableJavaScript;
    bool m_bEnablePlugins;
    bool m_bEnableCSS;
    QMap javaDomainPolicy;
    QMap javaScriptDomainPolicy;
    QMap fontsForCharset;
    QStringList defaultFonts;
    QString availFamilies;

    bool m_formCompletionEnabled;
    int m_maxFormCompletionItems;
};

#endif