KHTMLSettings Class Reference

#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 ()
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 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 344 of file khtml_settings.cpp.

KHTMLSettings::KHTMLSettings

(

const KHTMLSettings &

other

)

Definition at line 350 of file khtml_settings.cpp.

KHTMLSettings::~KHTMLSettings

(

)

[virtual]

Destructor.

Don't delete any instance by yourself.

Definition at line 357 of file khtml_settings.cpp.

---

Member Function Documentation

bool KHTMLSettings::accessKeysEnabled

(

)

const

Definition at line 839 of file khtml_settings.cpp.

void KHTMLSettings::addAdFilter

(

const QString &

url

)

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

const char * KHTMLSettings::adviceToStr

(

KJavaScriptAdvice

_advice

)

[static]

Definition at line 235 of file khtml_settings.cpp.

bool KHTMLSettings::allowTabulation

(

)

const

Definition at line 1189 of file khtml_settings.cpp.

bool KHTMLSettings::autoLoadImages

(

)

const

Definition at line 1145 of file khtml_settings.cpp.

bool KHTMLSettings::autoSpellCheck

(

)

const

Definition at line 1194 of file khtml_settings.cpp.

const QString & KHTMLSettings::availableFamilies

(

)

[static]

Definition at line 1020 of file khtml_settings.cpp.

const QColor & KHTMLSettings::baseColor

(

)

const

Definition at line 1130 of file khtml_settings.cpp.

bool KHTMLSettings::changeCursor

(

)

const

Definition at line 362 of file khtml_settings.cpp.

QString KHTMLSettings::cursiveFontName

(

)

const

Definition at line 1076 of file khtml_settings.cpp.

KHTMLSettings::KDNSPrefetch KHTMLSettings::dnsPrefetch

(

)

const

Definition at line 1165 of file khtml_settings.cpp.

const QString & KHTMLSettings::encoding

(

)

const

Definition at line 1115 of file khtml_settings.cpp.

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

(

)

const

Definition at line 1199 of file khtml_settings.cpp.

QString KHTMLSettings::fantasyFontName

(

)

const

Definition at line 1081 of file khtml_settings.cpp.

QString KHTMLSettings::fixedFontName

(

)

const

Definition at line 1061 of file khtml_settings.cpp.

bool KHTMLSettings::followSystemColors

(

)

const

Definition at line 1120 of file khtml_settings.cpp.

bool KHTMLSettings::hoverLink

(

)

const

Definition at line 372 of file khtml_settings.cpp.

void KHTMLSettings::init

(

)

Called by constructor and reparseConfiguration.

Definition at line 377 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 389 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 854 of file khtml_settings.cpp.

bool KHTMLSettings::isAdFilterEnabled

(

)

const

Definition at line 844 of file khtml_settings.cpp.

bool KHTMLSettings::isAutoDelayedActionsEnabled

(

)

const

Definition at line 1170 of file khtml_settings.cpp.

bool KHTMLSettings::isBackRightClickEnabled

(

)

Deprecated:

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

Definition at line 834 of file khtml_settings.cpp.

bool KHTMLSettings::isFormCompletionEnabled

(

)

const

Definition at line 1105 of file khtml_settings.cpp.

bool KHTMLSettings::isHideAdsEnabled

(

)

const

Definition at line 849 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 927 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaScriptDebugEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 937 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaScriptEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 932 of file khtml_settings.cpp.

bool KHTMLSettings::isJavaScriptErrorReportingEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 943 of file khtml_settings.cpp.

bool KHTMLSettings::isOpenMiddleClickEnabled

(

)

Definition at line 829 of file khtml_settings.cpp.

bool KHTMLSettings::isPluginsEnabled

(

const QString &

hostname = QString()

)

const

Definition at line 949 of file khtml_settings.cpp.

bool KHTMLSettings::jsErrorsEnabled

(

)

const

Definition at line 1175 of file khtml_settings.cpp.

bool KHTMLSettings::jsPopupBlockerPassivePopup

(

)

const

Definition at line 1213 of file khtml_settings.cpp.

const QColor & KHTMLSettings::linkColor

(

)

const

Definition at line 1135 of file khtml_settings.cpp.

int KHTMLSettings::maxFormCompletionItems

(

)

const

Definition at line 1110 of file khtml_settings.cpp.

int KHTMLSettings::mediumFontSize

(

)

const

Definition at line 979 of file khtml_settings.cpp.

int KHTMLSettings::minFontSize

(

)

const

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

QString KHTMLSettings::sansSerifFontName

(

)

const

Definition at line 1071 of file khtml_settings.cpp.

QString KHTMLSettings::serifFontName

(

)

const

Definition at line 1066 of file khtml_settings.cpp.

void KHTMLSettings::setFixedFontName

(

const QString &

n

)

Definition at line 1093 of file khtml_settings.cpp.

void KHTMLSettings::setJSErrorsEnabled

(

bool

enabled

)

Definition at line 1180 of file khtml_settings.cpp.

void KHTMLSettings::setJSPopupBlockerPassivePopup

(

bool

enabled

)

Definition at line 1204 of file khtml_settings.cpp.

void KHTMLSettings::setStdFontName

(

const QString &

n

)

Definition at line 1086 of file khtml_settings.cpp.

QString KHTMLSettings::settingsToCSS

(

)

const

Definition at line 989 of file khtml_settings.cpp.

KHTMLSettings::KAnimationAdvice KHTMLSettings::showAnimations

(

)

const

Definition at line 1155 of file khtml_settings.cpp.

KHTMLSettings::KSmoothScrollingMode KHTMLSettings::smoothScrolling

(

)

const

Definition at line 1160 of file khtml_settings.cpp.

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

Definition at line 246 of file khtml_settings.cpp.

QString KHTMLSettings::stdFontName

(

)

const

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

bool KHTMLSettings::underlineLink

(

)

const

Definition at line 367 of file khtml_settings.cpp.

bool KHTMLSettings::unfinishedImageFrame

(

)

const

Definition at line 1150 of file khtml_settings.cpp.

QString KHTMLSettings::userStyleSheet

(

)

const

Definition at line 1100 of file khtml_settings.cpp.

const QColor & KHTMLSettings::vLinkColor

(

)

const

Definition at line 1140 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowFocusPolicy KHTMLSettings::windowFocusPolicy

(

const QString &

hostname = QString()

)

const

Definition at line 974 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowMovePolicy KHTMLSettings::windowMovePolicy

(

const QString &

hostname = QString()

)

const

Definition at line 959 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowOpenPolicy KHTMLSettings::windowOpenPolicy

(

const QString &

hostname = QString()

)

const

Definition at line 954 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowResizePolicy KHTMLSettings::windowResizePolicy

(

const QString &

hostname = QString()

)

const

Definition at line 964 of file khtml_settings.cpp.

KHTMLSettings::KJSWindowStatusPolicy KHTMLSettings::windowStatusPolicy

(

const QString &

hostname = QString()

)

const

Definition at line 969 of file khtml_settings.cpp.

---

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

• khtml_settings.h
• khtml_settings.cpp