KHTMLSettings Class Reference

Settings for the HTML view. More...

#include <khtml_settings.h>

List of all members.

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 (KConfig *config, bool reset=true)
void	init ()
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 40 of file khtml_settings.h.

---

Member Enumeration Documentation

enum KHTMLSettings::KAnimationAdvice

Enumerator:

KAnimationDisabled
KAnimationLoopOnce
KAnimationEnabled

Definition at line 53 of file khtml_settings.h.

enum KHTMLSettings::KDNSPrefetch

Enumerator:

KDNSPrefetchDisabled
KDNSPrefetchOnlyWWWAndSLD
KDNSPrefetchEnabled

Definition at line 65 of file khtml_settings.h.

enum KHTMLSettings::KJavaScriptAdvice

This enum specifies whether Java/JavaScript execution is allowed.

Enumerator:

KJavaScriptDunno
KJavaScriptAccept
KJavaScriptReject

Definition at line 47 of file khtml_settings.h.

enum KHTMLSettings::KJSWindowFocusPolicy

This enum specifies the policy for window.focus.

Enumerator:

KJSWindowFocusAllow
KJSWindowFocusIgnore

Definition at line 108 of file khtml_settings.h.

enum KHTMLSettings::KJSWindowMovePolicy

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

Enumerator:

KJSWindowMoveAllow
KJSWindowMoveIgnore

Definition at line 92 of file khtml_settings.h.

enum KHTMLSettings::KJSWindowOpenPolicy

This enum specifies the policy for window.open.

Enumerator:

KJSWindowOpenAllow
KJSWindowOpenAsk
KJSWindowOpenDeny
KJSWindowOpenSmart

Definition at line 74 of file khtml_settings.h.

enum KHTMLSettings::KJSWindowResizePolicy

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

Enumerator:

KJSWindowResizeAllow
KJSWindowResizeIgnore

Definition at line 100 of file khtml_settings.h.

enum KHTMLSettings::KJSWindowStatusPolicy

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

Enumerator:

KJSWindowStatusAllow
KJSWindowStatusIgnore

Definition at line 84 of file khtml_settings.h.

enum KHTMLSettings::KSmoothScrollingMode

Enumerator:

KSmoothScrollingDisabled
KSmoothScrollingWhenEfficient
KSmoothScrollingEnabled

Definition at line 59 of file khtml_settings.h.

---

Constructor & Destructor Documentation

KHTMLSettings::KHTMLSettings

(

)

Constructor

Definition at line 341 of file khtml_settings.cpp.

KHTMLSettings::KHTMLSettings

(

const KHTMLSettings &

other

)

Definition at line 347 of file khtml_settings.cpp.

KHTMLSettings::~KHTMLSettings

(

)

[virtual]

Destructor.

Don't delete any instance by yourself.

Definition at line 354 of file khtml_settings.cpp.

---

Member Function Documentation

bool KHTMLSettings::accessKeysEnabled

(

)

const

Definition at line 832 of file khtml_settings.cpp.

void KHTMLSettings::addAdFilter

(

const QString &

url

)

Definition at line 881 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 860 of file khtml_settings.cpp.

const char * KHTMLSettings::adviceToStr

(

KJavaScriptAdvice

_advice

)

[static]

Definition at line 232 of file khtml_settings.cpp.

bool KHTMLSettings::allowTabulation

(

)

const

Definition at line 1182 of file khtml_settings.cpp.

bool KHTMLSettings::autoLoadImages

(

)

const

Definition at line 1138 of file khtml_settings.cpp.

bool KHTMLSettings::autoSpellCheck

(

)

const

Definition at line 1187 of file khtml_settings.cpp.

const QString & KHTMLSettings::availableFamilies

(

)

[static]

Definition at line 1013 of file khtml_settings.cpp.

const QColor & KHTMLSettings::baseColor

(

)

const

Definition at line 1123 of file khtml_settings.cpp.

bool KHTMLSettings::changeCursor

(

)

const

Definition at line 359 of file khtml_settings.cpp.

QString KHTMLSettings::cursiveFontName

(

)

const

Definition at line 1069 of file khtml_settings.cpp.

KHTMLSettings::KDNSPrefetch KHTMLSettings::dnsPrefetch

(

)

const

Definition at line 1158 of file khtml_settings.cpp.

const QString & KHTMLSettings::encoding

(

)

const

Definition at line 1108 of file khtml_settings.cpp.

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

(

)

const

Definition at line 1192 of file khtml_settings.cpp.

QString KHTMLSettings::fantasyFontName

(

)

const

Definition at line 1074 of file khtml_settings.cpp.

QString KHTMLSettings::fixedFontName

(

)

const

Definition at line 1054 of file khtml_settings.cpp.

bool KHTMLSettings::followSystemColors

(

)

const

Definition at line 1113 of file khtml_settings.cpp.

bool KHTMLSettings::hoverLink

(

)

const

Definition at line 369 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 existance 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 386 of file khtml_settings.cpp.

void KHTMLSettings::init

(

)

Called by constructor and reparseConfiguration.

Definition at line 374 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 847 of file khtml_settings.cpp.

bool KHTMLSettings::isAdFilterEnabled

(

)

const

Definition at line 837 of file khtml_settings.cpp.

bool KHTMLSettings::isAutoDelayedActionsEnabled

(

)

const

Definition at line 1163 of file khtml_settings.cpp.

bool KHTMLSettings::isBackRightClickEnabled

(

)

Deprecated:

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

Definition at line 827 of file khtml_settings.cpp.

bool KHTMLSettings::isFormCompletionEnabled

(

)

const

Definition at line 1098 of file khtml_settings.cpp.

bool KHTMLSettings::isHideAdsEnabled

(

)

const

Definition at line 842 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 920 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaScriptDebugEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 930 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaScriptEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 925 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaScriptErrorReportingEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 936 of file khtml_settings.cpp.

bool KHTMLSettings::isOpenMiddleClickEnabled

(

)

Definition at line 822 of file khtml_settings.cpp.

bool KHTMLSettings::isPluginsEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 942 of file khtml_settings.cpp.

bool KHTMLSettings::jsErrorsEnabled

(

)

const

Definition at line 1168 of file khtml_settings.cpp.

bool KHTMLSettings::jsPopupBlockerPassivePopup

(

)

const

Definition at line 1206 of file khtml_settings.cpp.

const QColor & KHTMLSettings::linkColor

(

)

const

Definition at line 1128 of file khtml_settings.cpp.

int KHTMLSettings::maxFormCompletionItems

(

)

const

Definition at line 1103 of file khtml_settings.cpp.

int KHTMLSettings::mediumFontSize

(

)

const

Definition at line 972 of file khtml_settings.cpp.

int KHTMLSettings::minFontSize

(

)

const

Definition at line 977 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 272 of file khtml_settings.cpp.

QString KHTMLSettings::sansSerifFontName

(

)

const

Definition at line 1064 of file khtml_settings.cpp.

QString KHTMLSettings::serifFontName

(

)

const

Definition at line 1059 of file khtml_settings.cpp.

void KHTMLSettings::setFixedFontName

(

const QString &

n

)

Definition at line 1086 of file khtml_settings.cpp.

void KHTMLSettings::setJSErrorsEnabled

(

bool

enabled

)

Definition at line 1173 of file khtml_settings.cpp.

void KHTMLSettings::setJSPopupBlockerPassivePopup

(

bool

enabled

)

Definition at line 1197 of file khtml_settings.cpp.

void KHTMLSettings::setStdFontName

(

const QString &

n

)

Definition at line 1079 of file khtml_settings.cpp.

QString KHTMLSettings::settingsToCSS

(

)

const

Definition at line 982 of file khtml_settings.cpp.

KHTMLSettings::KAnimationAdvice KHTMLSettings::showAnimations

(

)

const

Definition at line 1148 of file khtml_settings.cpp.

KHTMLSettings::KSmoothScrollingMode KHTMLSettings::smoothScrolling

(

)

const

Definition at line 1153 of file khtml_settings.cpp.

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

Definition at line 243 of file khtml_settings.cpp.

QString KHTMLSettings::stdFontName

(

)

const

Definition at line 1049 of file khtml_settings.cpp.

KHTMLSettings::KJavaScriptAdvice KHTMLSettings::strToAdvice

(

const QString &

_str

)

[static]

Definition at line 217 of file khtml_settings.cpp.

const QColor & KHTMLSettings::textColor

(

)

const

Definition at line 1118 of file khtml_settings.cpp.

bool KHTMLSettings::underlineLink

(

)

const

Definition at line 364 of file khtml_settings.cpp.

bool KHTMLSettings::unfinishedImageFrame

(

)

const

Definition at line 1143 of file khtml_settings.cpp.

QString KHTMLSettings::userStyleSheet

(

)

const

Definition at line 1093 of file khtml_settings.cpp.

const QColor & KHTMLSettings::vLinkColor

(

)

const

Definition at line 1133 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowFocusPolicy KHTMLSettings::windowFocusPolicy

(

const QString &

hostname = QString()

)

const

Definition at line 967 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowMovePolicy KHTMLSettings::windowMovePolicy

(

const QString &

hostname = QString()

)

const

Definition at line 952 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowOpenPolicy KHTMLSettings::windowOpenPolicy

(

const QString &

hostname = QString()

)

const

Definition at line 947 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowResizePolicy KHTMLSettings::windowResizePolicy

(

const QString &

hostname = QString()

)

const

Definition at line 957 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowStatusPolicy KHTMLSettings::windowStatusPolicy

(

const QString &

hostname = QString()

)

const

Definition at line 962 of file khtml_settings.cpp.

---

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

• khtml_settings.h
• khtml_settings.cpp