.TH "KInstance" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdecore Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KInstance \- Access to \fBKDE\fP global objects for use in shared libraries.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kinstance.h>\fP
.PP
Inherited by \fBKApplication\fP.
.PP
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKInstance\fP (const \fBQCString\fP &instanceName)"
.br
.ti -1c
.RI "\fBKInstance\fP (const \fBKAboutData\fP *aboutData)"
.br
.ti -1c
.RI "\fBKInstance\fP (\fBKInstance\fP *src)"
.br
.ti -1c
.RI "virtual \fB~KInstance\fP ()"
.br
.ti -1c
.RI "\fBKStandardDirs\fP * \fBdirs\fP () const "
.br
.ti -1c
.RI "\fBKConfig\fP * \fBconfig\fP () const "
.br
.ti -1c
.RI "\fBKSharedConfig\fP * \fBsharedConfig\fP () const "
.br
.ti -1c
.RI "\fBKIconLoader\fP * \fBiconLoader\fP () const "
.br
.ti -1c
.RI "void \fBnewIconLoader\fP () const "
.br
.ti -1c
.RI "const \fBKAboutData\fP * \fBaboutData\fP () const "
.br
.ti -1c
.RI "\fBQCString\fP \fBinstanceName\fP () const "
.br
.ti -1c
.RI "\fBKMimeSourceFactory\fP * \fBmimeSourceFactory\fP () const "
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "\fBKInstance\fP (const \fBKInstance\fP &)"
.br
.ti -1c
.RI "void \fBsetConfigName\fP (const \fBQString\fP &name)"
.br
.ti -1c
.RI "virtual void \fBvirtual_hook\fP (int id, void *data)"
.br
.in -1c
.SS "Friends"

.in +1c
.ti -1c
.RI "class \fBKStandardDirs\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
Access to \fBKDE\fP global objects for use in shared libraries. 

In practical terms, this class is used in \fBKDE\fP components. This allows components to store things that normally would be accessed by \fBKGlobal\fP.
.PP
\fBAuthor:\fP
.RS 4
Torben Weis 
.RE
.PP

.PP
Definition at line 43 of file kinstance.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KInstance::KInstance (const \fBQCString\fP & instanceName)"
.PP
Constructor. 
.PP
\fBParameters:\fP
.RS 4
\fIinstanceName\fP the name of the instance 
.RE
.PP

.PP
Definition at line 69 of file kinstance.cpp.
.PP
References KGlobal::setActiveInstance().
.SS "KInstance::KInstance (const \fBKAboutData\fP * aboutData)"
.PP
Constructor. 
.PP
When building a KInstance that is not your \fBKApplication\fP, make sure that the \fBKAboutData\fP and the KInstance have the same life time. You have to destroy both, since the instance doesn't own the about data. Don't build a \fBKAboutData\fP on the stack in this case ! Building a \fBKAboutData\fP on the stack is only ok for usage with \fBKCmdLineArgs\fP and \fBKApplication\fP (not destroyed until the app exits). 
.PP
\fBParameters:\fP
.RS 4
\fIaboutData\fP data about this instance (see \fBKAboutData\fP) 
.RE
.PP

.PP
Definition at line 87 of file kinstance.cpp.
.PP
References QCString::isEmpty(), and KGlobal::setActiveInstance().
.SS "KInstance::~\fBKInstance\fP ()\fC [virtual]\fP"
.PP
Destructor. 
.PP
Definition at line 132 of file kinstance.cpp.
.PP
References KGlobal::setActiveInstance().
.SS "KInstance::KInstance (const \fBKInstance\fP &)\fC [protected]\fP"
.PP
Copy Constructor is not allowed. 
.PP
.SH "Member Function Documentation"
.PP 
.SS "\fBKStandardDirs\fP * KInstance::dirs () const"
.PP
Returns the application standard dirs object. 
.PP
\fBReturns:\fP
.RS 4
The \fBKStandardDirs\fP of the application. 
.RE
.PP

.PP
Definition at line 159 of file kinstance.cpp.
.PP
References KConfig::reparseConfiguration().
.PP
Referenced by KGlobal::dirs(), KLibLoader::findLibrary(), iconLoader(), and newIconLoader().
.SS "\fBKConfig\fP * KInstance::config () const"
.PP
Returns the general config object ('appnamerc'). 
.PP
\fBReturns:\fP
.RS 4
the \fBKConfig\fP object for the instance. 
.RE
.PP

.PP
Definition at line 175 of file kinstance.cpp.
.PP
References KStandardDirs::addCustomized(), QCString::isEmpty(), KSharedConfig::openConfig(), and KConfig::reparseConfiguration().
.PP
Referenced by KGlobal::config(), KCmdLineArgs::enable_i18n(), KNotifyClient::Instance::Instance(), KApplication::invokeMailer(), KLocale::KLocale(), and sharedConfig().
.SS "\fBKSharedConfig\fP * KInstance::sharedConfig () const"
.PP
Returns the general config object ('appnamerc'). 
.PP
\fBReturns:\fP
.RS 4
the \fBKConfig\fP object for the instance. 
.RE
.PP

.PP
Definition at line 222 of file kinstance.cpp.
.PP
References config().
.PP
Referenced by KGlobal::sharedConfig().
.SS "\fBKIconLoader\fP * KInstance::iconLoader () const"
.PP
Returns an iconloader object. 
.PP
\fBReturns:\fP
.RS 4
the iconloader object. 
.RE
.PP

.PP
Definition at line 237 of file kinstance.cpp.
.PP
References dirs(), and KIconLoader::enableDelayedIconSetLoading().
.PP
Referenced by KIconLoader::BarIcon(), KIconLoader::BarIconSet(), KIconLoader::DesktopIcon(), KIconLoader::DesktopIconSet(), KGlobal::iconLoader(), KIconLoader::IconSize(), KIconLoader::MainBarIcon(), KIconLoader::MainBarIconSet(), mimeSourceFactory(), KIconLoader::SmallIcon(), KIconLoader::SmallIconSet(), KIconLoader::UserIcon(), and KIconLoader::UserIconSet().
.SS "void KInstance::newIconLoader () const"
.PP
Re-allocate the global iconloader. 
.PP
Definition at line 248 of file kinstance.cpp.
.PP
References dirs(), KIconLoader::reconfigure(), and KIconTheme::reconfigure().
.PP
Referenced by KApplication::x11EventFilter().
.SS "const \fBKAboutData\fP * KInstance::aboutData () const"
.PP
Returns the about data of this instance Warning, can be 0L. 
.PP
\fBReturns:\fP
.RS 4
the about data of the instance, or 0 if it has not been set yet 
.RE
.PP

.PP
Definition at line 255 of file kinstance.cpp.
.PP
Referenced by KApplication::caption(), and KCrash::defaultCrashHandler().
.SS "\fBQCString\fP KInstance::instanceName () const"
.PP
Returns the name of the instance. 
.PP
\fBReturns:\fP
.RS 4
the instance name, can be null if the KInstance has been created with a null name 
.RE
.PP

.PP
Definition at line 261 of file kinstance.cpp.
.PP
Referenced by KConfigBackEnd::checkConfigFilesWritable(), KApplication::iconName(), KApplication::KApplication(), and KApplication::miniIconName().
.SS "\fBKMimeSourceFactory\fP * KInstance::mimeSourceFactory () const"
.PP
Returns the \fBKMimeSourceFactory\fP of the instance. 
.PP
Mainly added for API completeness and future extensibility. 
.PP
\fBReturns:\fP
.RS 4
the \fBKMimeSourceFactory\fP set as default for this application. 
.RE
.PP

.PP
Definition at line 267 of file kinstance.cpp.
.PP
References iconLoader().
.SS "void KInstance::setConfigName (const \fBQString\fP & name)\fC [protected]\fP"
.PP
Set name of default config file. 
.PP
\fBParameters:\fP
.RS 4
\fIname\fP the name of the default config file 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP

.PP
Definition at line 231 of file kinstance.cpp.

.SH "Author"
.PP 
Generated automatically by Doxygen for kdecore Library from the source code.
