KHTMLSettings Class Reference

#include <khtml_settings.h>

Public Types
enum	KAnimationAdvice { KAnimationDisabled =0, KAnimationLoopOnce, KAnimationEnabled }
enum	KDNSPrefetch { KDNSPrefetchDisabled =0, KDNSPrefetchOnlyWWWAndSLD, KDNSPrefetchEnabled }
enum	KJavaScriptAdvice { KJavaScriptDunno =0, KJavaScriptAccept, KJavaScriptReject }
enum	KJSWindowFocusPolicy { KJSWindowFocusAllow =0, KJSWindowFocusIgnore }
enum	KJSWindowMovePolicy { KJSWindowMoveAllow =0, KJSWindowMoveIgnore }
enum	KJSWindowOpenPolicy { KJSWindowOpenAllow =0, KJSWindowOpenAsk, KJSWindowOpenDeny, KJSWindowOpenSmart }
enum	KJSWindowResizePolicy { KJSWindowResizeAllow =0, KJSWindowResizeIgnore }
enum	KJSWindowStatusPolicy { KJSWindowStatusAllow =0, KJSWindowStatusIgnore }
enum	KSmoothScrollingMode { KSmoothScrollingDisabled =0, KSmoothScrollingWhenEfficient, KSmoothScrollingEnabled }

Public Member Functions
	KHTMLSettings ()
	KHTMLSettings (const KHTMLSettings &other)
virtual	~KHTMLSettings ()
bool	accessKeysEnabled () const
void	addAdFilter (const QString &url)
QString	adFilteredBy (const QString &url, bool *isWhiteListed=0) const
bool	allowTabulation () const
bool	autoLoadImages () const
bool	autoSpellCheck () const
const QColor &	baseColor () const
bool	changeCursor () const
QString	cursiveFontName () const
KDNSPrefetch	dnsPrefetch () const
const QString &	encoding () const
QList< QPair< QString, QChar > >	fallbackAccessKeysAssignments () const
QString	fantasyFontName () const
QString	fixedFontName () const
bool	followSystemColors () const
bool	hoverLink () const
void	init ()
void	init (KConfig *config, bool reset=true)
bool	isAdFiltered (const QString &url) const
bool	isAdFilterEnabled () const
bool	isAutoDelayedActionsEnabled () const
bool	isBackRightClickEnabled ()
bool	isFormCompletionEnabled () const
bool	isHideAdsEnabled () const
bool	isJavaEnabled (const QString &hostname=QString()) const
bool	isJavaScriptDebugEnabled (const QString &hostname=QString()) const
bool	isJavaScriptEnabled (const QString &hostname=QString()) const
bool	isJavaScriptErrorReportingEnabled (const QString &hostname=QString()) const
bool	isOpenMiddleClickEnabled ()
bool	isPluginsEnabled (const QString &hostname=QString()) const
bool	jsErrorsEnabled () const
bool	jsPopupBlockerPassivePopup () const
const QColor &	linkColor () const
int	maxFormCompletionItems () const
int	mediumFontSize () const
int	minFontSize () const
void	readDomainSettings (const KConfigGroup &config, bool reset, bool global, KPerDomainSettings &pd_settings)
QString	sansSerifFontName () const
QString	serifFontName () const
void	setFixedFontName (const QString &n)
void	setJSErrorsEnabled (bool enabled)
void	setJSPopupBlockerPassivePopup (bool enabled)
void	setStdFontName (const QString &n)
QString	settingsToCSS () const
KAnimationAdvice	showAnimations () const
KSmoothScrollingMode	smoothScrolling () const
QString	stdFontName () const
const QColor &	textColor () const
bool	underlineLink () const
bool	unfinishedImageFrame () const
QString	userStyleSheet () const
const QColor &	vLinkColor () const
KJSWindowFocusPolicy	windowFocusPolicy (const QString &hostname=QString()) const
KJSWindowMovePolicy	windowMovePolicy (const QString &hostname=QString()) const
KJSWindowOpenPolicy	windowOpenPolicy (const QString &hostname=QString()) const
KJSWindowResizePolicy	windowResizePolicy (const QString &hostname=QString()) const
KJSWindowStatusPolicy	windowStatusPolicy (const QString &hostname=QString()) const

Static Public Member Functions
static const char *	adviceToStr (KJavaScriptAdvice _advice)
static const QString &	availableFamilies ()
static void	splitDomainAdvice (const QString &configStr, QString &domain, KJavaScriptAdvice &javaAdvice, KJavaScriptAdvice &javaScriptAdvice)
static KJavaScriptAdvice	strToAdvice (const QString &_str)

Detailed Description

Settings for the HTML view.

Definition at line 41 of file khtml_settings.h.

Member Enumeration Documentation

enum KHTMLSettings::KAnimationAdvice

Enumerator
KAnimationDisabled
KAnimationLoopOnce
KAnimationEnabled

Definition at line 54 of file khtml_settings.h.

enum KHTMLSettings::KDNSPrefetch

Enumerator
KDNSPrefetchDisabled
KDNSPrefetchOnlyWWWAndSLD
KDNSPrefetchEnabled

Definition at line 66 of file khtml_settings.h.

enum KHTMLSettings::KJavaScriptAdvice

This enum specifies whether Java/JavaScript execution is allowed.

Enumerator
KJavaScriptDunno
KJavaScriptAccept
KJavaScriptReject

Definition at line 48 of file khtml_settings.h.

enum KHTMLSettings::KJSWindowFocusPolicy

This enum specifies the policy for window.focus.

Enumerator
KJSWindowFocusAllow
KJSWindowFocusIgnore

Definition at line 109 of file khtml_settings.h.

enum KHTMLSettings::KJSWindowMovePolicy

This enum specifies the policy for window.moveBy and .moveTo.

Enumerator
KJSWindowMoveAllow
KJSWindowMoveIgnore

Definition at line 93 of file khtml_settings.h.

enum KHTMLSettings::KJSWindowOpenPolicy

This enum specifies the policy for window.open.

Enumerator
KJSWindowOpenAllow
KJSWindowOpenAsk
KJSWindowOpenDeny
KJSWindowOpenSmart

Definition at line 75 of file khtml_settings.h.

enum KHTMLSettings::KJSWindowResizePolicy

This enum specifies the policy for window.resizeBy and .resizeTo.

Enumerator
KJSWindowResizeAllow
KJSWindowResizeIgnore

Definition at line 101 of file khtml_settings.h.

enum KHTMLSettings::KJSWindowStatusPolicy

This enum specifies the policy for window.status and .defaultStatus.

Enumerator
KJSWindowStatusAllow
KJSWindowStatusIgnore

Definition at line 85 of file khtml_settings.h.

enum KHTMLSettings::KSmoothScrollingMode

Enumerator
KSmoothScrollingDisabled
KSmoothScrollingWhenEfficient
KSmoothScrollingEnabled

Definition at line 60 of file khtml_settings.h.

Constructor & Destructor Documentation

KHTMLSettings::KHTMLSettings

(

)

Constructor

Definition at line 309 of file khtml_settings.cpp.

KHTMLSettings::KHTMLSettings

(

const KHTMLSettings &

other

)

Definition at line 315 of file khtml_settings.cpp.

KHTMLSettings::~KHTMLSettings ( )

virtual

Destructor.

Don't delete any instance by yourself.

Definition at line 322 of file khtml_settings.cpp.

Member Function Documentation

bool KHTMLSettings::accessKeysEnabled

(

)

const

Definition at line 818 of file khtml_settings.cpp.

void KHTMLSettings::addAdFilter

(

const QString &

url

)

Definition at line 867 of file khtml_settings.cpp.

QString KHTMLSettings::adFilteredBy	(	const QString &	url,
		bool *	isWhiteListed = 0
	)		const

identify the filter which matches url.

Parameters

url	the URL to test.
isWhiteListed	if not NULL, set to true if the URL matched a whitelist filter; set to false if it matched a blacklist filter.

Returns

the filter string that matched, or QString() if no filter matched.

Since

4.4

Definition at line 846 of file khtml_settings.cpp.

const char * KHTMLSettings::adviceToStr ( KJavaScriptAdvice  _advice )

static

Definition at line 225 of file khtml_settings.cpp.

bool KHTMLSettings::allowTabulation

(

)

const

Definition at line 1168 of file khtml_settings.cpp.

bool KHTMLSettings::autoLoadImages

(

)

const

Definition at line 1124 of file khtml_settings.cpp.

bool KHTMLSettings::autoSpellCheck

(

)

const

Definition at line 1173 of file khtml_settings.cpp.

const QString & KHTMLSettings::availableFamilies ( )

static

Definition at line 999 of file khtml_settings.cpp.

const QColor & KHTMLSettings::baseColor

(

)

const

Definition at line 1109 of file khtml_settings.cpp.

bool KHTMLSettings::changeCursor

(

)

const

Definition at line 327 of file khtml_settings.cpp.

QString KHTMLSettings::cursiveFontName

(

)

const

Definition at line 1055 of file khtml_settings.cpp.

KHTMLSettings::KDNSPrefetch KHTMLSettings::dnsPrefetch

(

)

const

Definition at line 1144 of file khtml_settings.cpp.

const QString & KHTMLSettings::encoding

(

)

const

Definition at line 1094 of file khtml_settings.cpp.

QList< QPair< QString, QChar > > KHTMLSettings::fallbackAccessKeysAssignments

(

)

const

Definition at line 1178 of file khtml_settings.cpp.

QString KHTMLSettings::fantasyFontName

(

)

const

Definition at line 1060 of file khtml_settings.cpp.

QString KHTMLSettings::fixedFontName

(

)

const

Definition at line 1040 of file khtml_settings.cpp.

bool KHTMLSettings::followSystemColors

(

)

const

Definition at line 1099 of file khtml_settings.cpp.

bool KHTMLSettings::hoverLink

(

)

const

Definition at line 337 of file khtml_settings.cpp.

void KHTMLSettings::init

(

)

Called by constructor and reparseConfiguration.

Definition at line 342 of file khtml_settings.cpp.

void KHTMLSettings::init	(	KConfig *	config,
		bool	reset = true
	)

Read settings from config.

Parameters

config	is a pointer to KConfig object.
reset	if true, settings are always set; if false, settings are only set if the config file has a corresponding key.

read maximum age for filter list files, minimum is one day

check if entry is enabled

get url for HTMLFilterList

determine where to cache HTMLFilterList file

determine existence and age of cache file

load cached file if it exists, irrespective of age

if no cache list file exists or if it is too old ...

... in this case, refetch list asynchronously

for later reference, store name of cache file

Definition at line 354 of file khtml_settings.cpp.

bool KHTMLSettings::isAdFiltered

(

const QString &

url

)

const

tests whether url is filtered.

Parameters

url	the URL to test.

Returns

true if the URL is blacklisted and is not whitelisted.

Definition at line 833 of file khtml_settings.cpp.

bool KHTMLSettings::isAdFilterEnabled

(

)

const

Definition at line 823 of file khtml_settings.cpp.

bool KHTMLSettings::isAutoDelayedActionsEnabled

(

)

const

Definition at line 1149 of file khtml_settings.cpp.

bool KHTMLSettings::isBackRightClickEnabled

(

)

Deprecated:

do not use, feature was moved to be only in konqueror

Definition at line 813 of file khtml_settings.cpp.

bool KHTMLSettings::isFormCompletionEnabled

(

)

const

Definition at line 1084 of file khtml_settings.cpp.

bool KHTMLSettings::isHideAdsEnabled

(

)

const

Definition at line 828 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 906 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaScriptDebugEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 916 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaScriptEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 911 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaScriptErrorReportingEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 922 of file khtml_settings.cpp.

bool KHTMLSettings::isOpenMiddleClickEnabled

(

)

Definition at line 808 of file khtml_settings.cpp.

bool KHTMLSettings::isPluginsEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 928 of file khtml_settings.cpp.

bool KHTMLSettings::jsErrorsEnabled

(

)

const

Definition at line 1154 of file khtml_settings.cpp.

bool KHTMLSettings::jsPopupBlockerPassivePopup

(

)

const

Definition at line 1192 of file khtml_settings.cpp.

const QColor & KHTMLSettings::linkColor

(

)

const

Definition at line 1114 of file khtml_settings.cpp.

int KHTMLSettings::maxFormCompletionItems

(

)

const

Definition at line 1089 of file khtml_settings.cpp.

int KHTMLSettings::mediumFontSize

(

)

const

Definition at line 958 of file khtml_settings.cpp.

int KHTMLSettings::minFontSize

(

)

const

Definition at line 963 of file khtml_settings.cpp.

void KHTMLSettings::readDomainSettings	(	const KConfigGroup &	config,
		bool	reset,
		bool	global,
		KPerDomainSettings &	pd_settings
	)

reads from config's current group, forcing initialization if reset is true.

Parameters

config	is a pointer to KConfig object.
reset	true if initialization is to be forced.
global	true if the global domain is to be read.
pd_settings	will be initialised with the computed (inherited) settings.

Definition at line 240 of file khtml_settings.cpp.

QString KHTMLSettings::sansSerifFontName

(

)

const

Definition at line 1050 of file khtml_settings.cpp.

QString KHTMLSettings::serifFontName

(

)

const

Definition at line 1045 of file khtml_settings.cpp.

void KHTMLSettings::setFixedFontName

(

const QString &

n

)

Definition at line 1072 of file khtml_settings.cpp.

void KHTMLSettings::setJSErrorsEnabled

(

bool

enabled

)

Definition at line 1159 of file khtml_settings.cpp.

void KHTMLSettings::setJSPopupBlockerPassivePopup

(

bool

enabled

)

Definition at line 1183 of file khtml_settings.cpp.

void KHTMLSettings::setStdFontName

(

const QString &

n

)

Definition at line 1065 of file khtml_settings.cpp.

QString KHTMLSettings::settingsToCSS

(

)

const

Definition at line 968 of file khtml_settings.cpp.

KHTMLSettings::KAnimationAdvice KHTMLSettings::showAnimations

(

)

const

Definition at line 1134 of file khtml_settings.cpp.

KHTMLSettings::KSmoothScrollingMode KHTMLSettings::smoothScrolling

(

)

const

Definition at line 1139 of file khtml_settings.cpp.

void KHTMLSettings::splitDomainAdvice ( const QString &  configStr, QString &  domain, KJavaScriptAdvice &  javaAdvice, KJavaScriptAdvice &  javaScriptAdvice  )

static

Definition at line 231 of file khtml_settings.cpp.

QString KHTMLSettings::stdFontName

(

)

const

Definition at line 1035 of file khtml_settings.cpp.

KHTMLSettings::KJavaScriptAdvice KHTMLSettings::strToAdvice ( const QString &  _str )

static

Definition at line 220 of file khtml_settings.cpp.

const QColor & KHTMLSettings::textColor

(

)

const

Definition at line 1104 of file khtml_settings.cpp.

bool KHTMLSettings::underlineLink

(

)

const

Definition at line 332 of file khtml_settings.cpp.

bool KHTMLSettings::unfinishedImageFrame

(

)

const

Definition at line 1129 of file khtml_settings.cpp.

QString KHTMLSettings::userStyleSheet

(

)

const

Definition at line 1079 of file khtml_settings.cpp.

const QColor & KHTMLSettings::vLinkColor

(

)

const

Definition at line 1119 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowFocusPolicy KHTMLSettings::windowFocusPolicy

(

const QString &

hostname = QString()

)

const

Definition at line 953 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowMovePolicy KHTMLSettings::windowMovePolicy

(

const QString &

hostname = QString()

)

const

Definition at line 938 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowOpenPolicy KHTMLSettings::windowOpenPolicy

(

const QString &

hostname = QString()

)

const

Definition at line 933 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowResizePolicy KHTMLSettings::windowResizePolicy

(

const QString &

hostname = QString()

)

const

Definition at line 943 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowStatusPolicy KHTMLSettings::windowStatusPolicy

(

const QString &

hostname = QString()

)

const

Definition at line 948 of file khtml_settings.cpp.

---

The documentation for this class was generated from the following files:

• khtml_settings.h
• khtml_settings.cpp