kio Library API Documentation

KURIFilterPlugin Class Reference

Base class for URI filter plugins. Abstract class for URI filter plugins. More...

#include <kurifilter.h>

Inheritance diagram for KURIFilterPlugin:

QObject List of all members.

Public Member Functions

 KURIFilterPlugin (QObject *parent=0, const char *name=0, double pri=1.0)
virtual QString name () const
virtual double priority () const
virtual bool filterURI (KURIFilterData &data) const =0
virtual KCModuleconfigModule (QWidget *, const char *) const
virtual QString configName () const

Protected Member Functions

void setFilteredURI (KURIFilterData &data, const KURL &uri) const
void setErrorMsg (KURIFilterData &data, const QString &errmsg) const
void setURIType (KURIFilterData &data, KURIFilterData::URITypes type) const
void setArguments (KURIFilterData &data, const QString &args) const
virtual void virtual_hook (int id, void *data)

Protected Attributes

QString m_strName
double m_dblPriority

Detailed Description

Base class for URI filter plugins. Abstract class for URI filter plugins.

This class applies a single filter to a URI. All plugins designed to provide URI filtering service should inherit from this abstract class and provide a concrete implementation.

All inheriting classes need to implement the pure virtual function filterURI.

Definition at line 341 of file kurifilter.h.


Constructor & Destructor Documentation

KURIFilterPlugin::KURIFilterPlugin QObject parent = 0,
const char *  name = 0,
double  pri = 1.0
 

Constructs a filter plugin with a given name and priority.

Parameters:
parent the parent object, or 0 for no parent
name the name of the plugin, or 0 for no name
pri the priority of the plugin.

Definition at line 35 of file kurifilter.cpp.


Member Function Documentation

virtual QString KURIFilterPlugin::name  )  const [inline, virtual]
 

Returns the filter's name.

Returns:
A string naming the filter.

Definition at line 362 of file kurifilter.h.

Referenced by configName().

virtual double KURIFilterPlugin::priority  )  const [inline, virtual]
 

Returns the filter's priority.

Each filter has an assigned priority, a float from 0 to 1. Filters with the lowest priority are first given a chance to filter a URI.

Returns:
The priority of the filter.

Definition at line 372 of file kurifilter.h.

virtual bool KURIFilterPlugin::filterURI KURIFilterData data  )  const [pure virtual]
 

Filters a URI.

Parameters:
data the URI data to be filtered.
Returns:
A boolean indicating whether the URI has been changed.

virtual KCModule* KURIFilterPlugin::configModule QWidget ,
const char * 
const [inline, virtual]
 

Creates a configuration module for the filter.

It is the responsibility of the caller to delete the module once it is not needed anymore.

Returns:
A configuration module, 0 if the filter isn't configurable.

Definition at line 390 of file kurifilter.h.

virtual QString KURIFilterPlugin::configName  )  const [inline, virtual]
 

Returns the name of the configuration module for the filter.

Returns:
the name of a configuration module or QString::null if none.

Definition at line 397 of file kurifilter.h.

References name().

void KURIFilterPlugin::setFilteredURI KURIFilterData data,
const KURL uri
const [protected]
 

Sets the the URL in data to uri.

Definition at line 42 of file kurifilter.cpp.

References KURIFilterData::m_bChanged, KURIFilterData::m_pURI, and KURIFilterData::uri().

void KURIFilterPlugin::setErrorMsg KURIFilterData data,
const QString errmsg
const [inline, protected]
 

Sets the error message in data to errormsg.

Definition at line 409 of file kurifilter.h.

References KURIFilterData::m_strErrMsg.

void KURIFilterPlugin::setURIType KURIFilterData data,
KURIFilterData::URITypes  type
const [inline, protected]
 

Sets the URI type in data to type.

Definition at line 416 of file kurifilter.h.

References KURIFilterData::m_bChanged, and KURIFilterData::m_iType.

void KURIFilterPlugin::setArguments KURIFilterData data,
const QString args
const [protected]
 

Sets the arguments and options string in data to args if any were found during filterting.

Definition at line 200 of file kurifilter.cpp.

References KURIFilterData::d.


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kio Library Version 3.3.0.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Thu Sep 23 17:12:29 2004 by doxygen 1.3.8-20040913 written by Dimitri van Heesch, © 1997-2003