khtml Library API Documentation

khtml_factory.cpp

00001 /* This file is part of the KDE project
00002  *
00003  * Copyright (C) 2000 Simon Hausmann <hausmann@kde.org>
00004  *
00005  * This library is free software; you can redistribute it and/or
00006  * modify it under the terms of the GNU Library General Public
00007  * License as published by the Free Software Foundation; either
00008  * version 2 of the License, or (at your option) any later version.
00009  *
00010  * This library is distributed in the hope that it will be useful,
00011  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00012  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013  * Library General Public License for more details.
00014  *
00015  * You should have received a copy of the GNU Library General Public License
00016  * along with this library; see the file COPYING.LIB.  If not, write to
00017  * the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
00018  * Boston, MA 02111-1307, USA.
00019  */
00020 
00021 #include "khtml_factory.h"
00022 #include "khtml_part.h"
00023 #include "khtml_settings.h"
00024 
00025 #include "css/cssstyleselector.h"
00026 #include "html/html_imageimpl.h"
00027 #include "rendering/render_style.h"
00028 #include "misc/loader.h"
00029 
00030 #include <kinstance.h>
00031 #include <kaboutdata.h>
00032 #include <klocale.h>
00033 
00034 #include <assert.h>
00035 
00036 #include <kdebug.h>
00037 
00038 template class QPtrList<KHTMLPart>;
00039 
00040 extern "C" void *init_libkhtml()
00041 {
00042     // We can't use a plain self() here, because that would
00043     // return the global factory, which might already exist
00044     // at the time init_libkhtml is called! As soon as someone
00045     // does new KHTMLPart() in his application and loads up
00046     // an html document into that part which either embeds
00047     // embeds another KHTMLPart instance via <object> or
00048     // as html frame, then we cannot return self(), as
00049     // what we return here is what the KLibLoader deletes
00050     // in the end, and we don't want the libloader to
00051     // delete our global instance. Anyway, the new
00052     // KHTMLFactory we create here is very cheap :)
00053     // (Simon)
00054     return new KHTMLFactory( true );
00055 }
00056 
00057 KHTMLFactory *KHTMLFactory::s_self = 0;
00058 unsigned long int KHTMLFactory::s_refcnt = 0;
00059 KInstance *KHTMLFactory::s_instance = 0;
00060 KAboutData *KHTMLFactory::s_about = 0;
00061 KHTMLSettings *KHTMLFactory::s_settings = 0;
00062 QPtrList<KHTMLPart> *KHTMLFactory::s_parts = 0;
00063 QString *KHTMLSettings::avFamilies = 0;
00064 
00065 KHTMLFactory::KHTMLFactory( bool clone )
00066 {
00067     if ( clone )
00068         ref();
00069 }
00070 
00071 KHTMLFactory::~KHTMLFactory()
00072 {
00073     if ( s_self == this )
00074     {
00075         assert( !s_refcnt );
00076 
00077         delete s_instance;
00078         delete s_about;
00079         delete s_settings;
00080     delete KHTMLSettings::avFamilies;
00081         if ( s_parts )
00082         {
00083             assert( s_parts->isEmpty() );
00084             delete s_parts;
00085         }
00086 
00087         s_instance = 0;
00088         s_about = 0;
00089         s_settings = 0;
00090         s_parts = 0;
00091     KHTMLSettings::avFamilies = 0;
00092 
00093         kdDebug( 6000 ) << "KHTMLFactory::~KHTMLFactory" << endl;
00094         // clean up static data
00095         khtml::CSSStyleSelector::clear();
00096         khtml::RenderStyle::cleanup();
00097         khtml::Cache::clear();
00098     }
00099     else
00100         deref();
00101 }
00102 
00103 KParts::Part *KHTMLFactory::createPartObject( QWidget *parentWidget, const char *widgetName, QObject *parent, const char *name, const char *className, const QStringList & )
00104 {
00105   KHTMLPart::GUIProfile prof = KHTMLPart::DefaultGUI;
00106   if ( strcmp( className, "Browser/View" ) == 0 )
00107     prof = KHTMLPart::BrowserViewGUI;
00108 
00109   return new KHTMLPart( parentWidget, widgetName, parent, name, prof );
00110 }
00111 
00112 void KHTMLFactory::ref()
00113 {
00114     if ( !s_refcnt && !s_self )
00115     {
00116         // we can't use a staticdeleter here, because that would mean
00117         // that the factory gets deleted from within a qPostRoutine, called
00118         // from the QApplication destructor. That however is too late, because
00119         // we want to destruct a KInstance object, which involves destructing
00120         // a KConfig object, which might call KGlobal::dirs() (in sync()) which
00121         // probably is not going to work ;-)
00122         // well, perhaps I'm wrong here, but as I'm unsure I try to stay on the
00123         // safe side ;-) -> let's use a simple reference counting scheme
00124         // (Simon)
00125         s_self = new KHTMLFactory;
00126         khtml::Cache::init();
00127     }
00128 
00129     s_refcnt++;
00130 }
00131 
00132 void KHTMLFactory::deref()
00133 {
00134     if ( !--s_refcnt && s_self )
00135     {
00136         delete s_self;
00137         s_self = 0;
00138     }
00139 }
00140 
00141 void KHTMLFactory::registerPart( KHTMLPart *part )
00142 {
00143     if ( !s_parts )
00144         s_parts = new QPtrList<KHTMLPart>;
00145 
00146     if ( !s_parts->containsRef( part ) )
00147     {
00148         s_parts->append( part );
00149         ref();
00150     }
00151 }
00152 
00153 void KHTMLFactory::deregisterPart( KHTMLPart *part )
00154 {
00155     assert( s_parts );
00156 
00157     if ( s_parts->removeRef( part ) )
00158     {
00159         if ( s_parts->isEmpty() )
00160         {
00161             delete s_parts;
00162             s_parts = 0;
00163         }
00164         deref();
00165     }
00166 }
00167 
00168 KInstance *KHTMLFactory::instance()
00169 {
00170   assert( s_self );
00171 
00172   if ( !s_instance )
00173   {
00174     s_about = new KAboutData( "khtml", I18N_NOOP( "KHTML" ), "4.0",
00175                               I18N_NOOP( "Embeddable HTML component" ),
00176                               KAboutData::License_LGPL );
00177     s_about->addAuthor( "Lars Knoll", 0, "knoll@kde.org" );
00178     s_about->addAuthor( "Antti Koivisto", 0, "koivisto@kde.org" );
00179     s_about->addAuthor( "Waldo Bastian", 0, "bastian@kde.org" );
00180     s_about->addAuthor( "Dirk Mueller", 0, "mueller@kde.org" );
00181     s_about->addAuthor( "Peter Kelly", 0, "pmk@kde.org" );
00182     s_about->addAuthor( "Torben Weis", 0, "weis@kde.org" );
00183     s_about->addAuthor( "Martin Jones", 0, "mjones@kde.org" );
00184     s_about->addAuthor( "Simon Hausmann", 0, "hausmann@kde.org" );
00185     s_about->addAuthor( "Tobias Anton", 0, "anton@stud.fbi.fh-darmstadt.de" );
00186 
00187     s_instance = new KInstance( s_about );
00188   }
00189 
00190   return s_instance;
00191 }
00192 
00193 KHTMLSettings *KHTMLFactory::defaultHTMLSettings()
00194 {
00195   assert( s_self );
00196   if ( !s_settings )
00197     s_settings = new KHTMLSettings();
00198 
00199   return s_settings;
00200 }
00201 
00202 using namespace KParts;
00203 #include "khtml_factory.moc"
00204 
KDE Logo
This file is part of the documentation for khtml Library Version 3.2.0.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Wed Feb 4 12:37:17 2004 by doxygen 1.2.18 written by Dimitri van Heesch, © 1997-2003