|
|
Base class for URI filter plugins.
This class applies a single filter to a URI. All plugins designed to provide URI filtering functionalities should inherit from this abstract class and provide a specific filtering implementation.
All inheriting classes need to implement the pure virtual function filterURI. Otherwise, they would also become abstract.
KURIFilterPlugin ( QObject *parent = 0, const char *name = 0, double pri = 1.0 )
| KURIFilterPlugin |
Constructor to create a filter plugin with a given name and priority.
Parameters:
parent | the parent object. |
name | the name of the plugin. |
pri | the priority of the plugin. |
QString name ()
| name |
[const virtual]
Return the filter's name.
Returns: A string naming the filter.
Reimplemented from QObject.
double priority ()
| priority |
[const virtual]
Return the filter's .
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.
bool filterURI ( KURIFilterData& data )
| filterURI |
[const pure virtual]
Filters a URI.
Parameters:
data | the URI data to be filtered. |
Returns: A boolean indicating whether the URI has been changed.
KCModule * configModule ( QWidget*, const char* )
| configModule |
[const virtual]
Returns a configuration module for the filter.
It is the responsability of the caller to delete the module once it is not needed anymore.
Returns: A configuration module, null
if the filter isn't configurable.
QString configName ()
| configName |
[const virtual]
Returns the name of the configuration module for the filter.
Returns: the name of a configuration module or null
if none.
void setFilteredURI ( KURIFilterData& data, const KURL& uri )
| setFilteredURI |
[protected const]
Sets the the URL in data
to uri
.
void setErrorMsg ( KURIFilterData& data, const QString& errmsg )
| setErrorMsg |
[protected const]
Sets the error message in data
to errormsg
.
void setURIType ( KURIFilterData& data, KURIFilterData::URITypes type)
| setURIType |
[protected const]
Sets the URI type in data
to type
.
void setArguments ( KURIFilterData& data, const QString& args )
| setArguments |
[protected const]
Sets the arguments and options string in data
to args
if any were found during filterting.
QString m_strName | m_strName |
[protected]
double m_dblPriority | m_dblPriority |
[protected]
Generated by: dfaure on kde.faure.org on Thu Jan 17 22:16:53 2002, using kdoc 2.0a53. |