.PP
.TH "KAboutData" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdecore Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KAboutData \- This class is used to store information about a program. Holds information needed by the 'About' box and other classes.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kaboutdata.h>\fP
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBLicenseKey\fP { \fBLicense_Custom\fP =  -2, \fBLicense_File\fP =  -1, \fBLicense_Unknown\fP =  0, \fBLicense_GPL\fP =  1, \fBLicense_GPL_V2\fP =  1, \fBLicense_LGPL\fP =  2, \fBLicense_LGPL_V2\fP =  2, \fBLicense_BSD\fP =  3, \fBLicense_Artistic\fP =  4, \fBLicense_QPL\fP =  5, \fBLicense_QPL_V1_0\fP =  5 }"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKAboutData\fP (const char *appName, const char *programName, const char *version, const char *shortDescription=0, int licenseType=License_Unknown, const char *copyrightStatement=0, const char *text=0, const char *homePageAddress=0, const char *bugsEmailAddress='submit@bugs.kde.org')"
.br
.ti -1c
.RI "void \fBaddAuthor\fP (const char *name, const char *task=0, const char *emailAddress=0, const char *webAddress=0)"
.br
.ti -1c
.RI "void \fBaddCredit\fP (const char *name, const char *task=0, const char *emailAddress=0, const char *webAddress=0)"
.br
.ti -1c
.RI "void \fBsetTranslator\fP (const char *name, const char *emailAddress)"
.br
.ti -1c
.RI "void \fBsetLicenseText\fP (const char *license)"
.br
.ti -1c
.RI "void \fBsetLicenseTextFile\fP (const \fBQString\fP &file)"
.br
.ti -1c
.RI "void \fBsetAppName\fP (const char *appName)"
.br
.ti -1c
.RI "void \fBsetProgramName\fP (const char *programName)"
.br
.ti -1c
.RI "void \fBsetProgramLogo\fP (const \fBQImage\fP &image)"
.br
.ti -1c
.RI "void \fBsetVersion\fP (const char *version)"
.br
.ti -1c
.RI "void \fBsetShortDescription\fP (const char *shortDescription)"
.br
.ti -1c
.RI "void \fBsetLicense\fP (\fBLicenseKey\fP licenseKey)"
.br
.ti -1c
.RI "void \fBsetCopyrightStatement\fP (const char *copyrightStatement)"
.br
.ti -1c
.RI "void \fBsetOtherText\fP (const char *otherText)"
.br
.ti -1c
.RI "void \fBsetHomepage\fP (const char *homepage)"
.br
.ti -1c
.RI "void \fBsetBugAddress\fP (const char *bugAddress)"
.br
.ti -1c
.RI "void \fBsetProductName\fP (const char *name)"
.br
.ti -1c
.RI "const char * \fBappName\fP () const "
.br
.ti -1c
.RI "const char * \fBproductName\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBprogramName\fP () const "
.br
.ti -1c
.RI "\fBQImage\fP \fBprogramLogo\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBversion\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBshortDescription\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBhomepage\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBbugAddress\fP () const "
.br
.ti -1c
.RI "const \fBQValueList\fP< \fBKAboutPerson\fP > \fBauthors\fP () const "
.br
.ti -1c
.RI "const \fBQValueList\fP< \fBKAboutPerson\fP > \fBcredits\fP () const "
.br
.ti -1c
.RI "const \fBQValueList\fP< \fBKAboutTranslator\fP > \fBtranslators\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBotherText\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBlicense\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBcopyrightStatement\fP () const "
.br
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "static \fBQString\fP \fBaboutTranslationTeam\fP ()"
.br
.in -1c
.SH "Detailed Description"
.PP 
This class is used to store information about a program. Holds information needed by the 'About' box and other classes. 

It can store such values as version number, program name, home page, email address for bug reporting, multiple authors and contributors (using \fBKAboutPerson\fP), license and copyright information.
.PP
Currently, the values set here are shown by the 'About' box (see \fBKAboutDialog\fP), used by the bug report dialog (see \fBKBugReport\fP), and by the help shown on command line (see \fBKCmdLineArgs\fP).
.PP
\fBAuthor:\fP
.RS 4
Espen Sand (espen@kde.org), David Faure (faure@kde.org) 
.RE
.PP

.PP
Definition at line 180 of file kaboutdata.h.
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBKAboutData::LicenseKey\fP"
.PP
Descibes the license of the software. 
.PP
Definition at line 186 of file kaboutdata.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KAboutData::KAboutData (const char * appName, const char * programName, const char * version, const char * shortDescription = \fC0\fP, int licenseType = \fCLicense_Unknown\fP, const char * copyrightStatement = \fC0\fP, const char * text = \fC0\fP, const char * homePageAddress = \fC0\fP, const char * bugsEmailAddress = \fC'submit@bugs.kde.org'\fP)"
.PP
Constructor. 
.PP
\fBParameters:\fP
.RS 4
\fIappName\fP The program name used internally. Example: 'kedit'
.br
\fIprogramName\fP A displayable program name string. This string should be marked for translation. Example: I18N_NOOP('KEdit')
.br
\fIversion\fP The program version string.
.br
\fIshortDescription\fP A short description of what the program does. This string should be marked for translation. Example: I18N_NOOP('A simple text editor.')
.br
\fIlicenseType\fP The license identifier. Use setLicenseText if you use a license not predefined here.
.br
\fIcopyrightStatement\fP A copyright statement, that can look like this: '(c) 1999-2000, Name'. The string specified here is not modified in any manner. The author information from addAuthor is not used.
.br
\fItext\fP Some free form text, that can contain any kind of information. The text can contain newlines. This string should be marked for translation.
.br
\fIhomePageAddress\fP The program homepage string. Start the address with 'http://'. 'http://some.domain' is is correct, 'some.domain' is not.
.br
\fIbugsEmailAddress\fP The bug report email address string. This defaults to the kde.org bug system. 
.RE
.PP

.PP
Definition at line 95 of file kaboutdata.cpp.
.PP
References appName().
.SH "Member Function Documentation"
.PP 
.SS "void KAboutData::addAuthor (const char * name, const char * task = \fC0\fP, const char * emailAddress = \fC0\fP, const char * webAddress = \fC0\fP)"
.PP
Defines an author. 
.PP
You can call this function as many times you need. Each entry is appended to a list. The person in the first entry is assumed to be the leader of the project.
.PP
\fBParameters:\fP
.RS 4
\fIname\fP The developer's name in UTF-8 encoding.
.br
\fItask\fP What the person is responsible for. This text can contain newlines. It should be marked for translation like this: I18N_NOOP('Task description...'). Can be 0.
.br
\fIemailAddress\fP An Email address where the person can be reached. Can be 0.
.br
\fIwebAddress\fP The person's homepage or a relevant link. Start the address with 'http://'. 'http://some.domain' is correct, 'some.domain' is not. Can be 0. 
.RE
.PP

.PP
Definition at line 135 of file kaboutdata.cpp.
.PP
References QValueList::append().
.SS "void KAboutData::addCredit (const char * name, const char * task = \fC0\fP, const char * emailAddress = \fC0\fP, const char * webAddress = \fC0\fP)"
.PP
Defines a person that deserves credit. 
.PP
You can call this function as many times you need. Each entry is appended to a list.
.PP
\fBParameters:\fP
.RS 4
\fIname\fP The person's name in UTF-8 encoding.
.br
\fItask\fP What the person has done to deserve the honor. The text can contain newlines. It should be marked for translation like this: I18N_NOOP('Task description...') Can be 0.
.br
\fIemailAddress\fP An Email address when the person can be reached. Can be 0.
.br
\fIwebAddress\fP The person's homepage or a relevant link. Start the address with 'http://'. 'http://some.domain' is is correct, 'some.domain' is not. Can be 0. 
.RE
.PP

.PP
Definition at line 142 of file kaboutdata.cpp.
.PP
References QValueList::append().
.SS "void KAboutData::setTranslator (const char * name, const char * emailAddress)"
.PP
Sets the name of the translator of the gui. 
.PP
Since this depends on the language, just use a dummy text marked for translation.
.PP
For example: 
.PP
.nf
 setTranslator(I18N_NOOP('_: NAME OF TRANSLATORS\\nYour names')
 ,I18N_NOOP('_: EMAIL OF TRANSLATORS\\nYour emails'));

.fi
.PP
.PP
The translator can then translate this dummy text with his name or with a list of names separated with ','. If there is no translation or the application is used with the default language, this function call is ignored.
.PP
Note: If you are using the default \fBKDE\fP automake environment, there is no need to use this function, because the two default strings above are added to the applications po file automatically.
.PP
\fBParameters:\fP
.RS 4
\fIname\fP the name of the translator 
.br
\fIemailAddress\fP the email address of the translator 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBKAboutTranslator\fP 
.RE
.PP

.PP
Definition at line 149 of file kaboutdata.cpp.
.SS "void KAboutData::setLicenseText (const char * license)"
.PP
Defines a license text. 
.PP
The text will be translated if it got marked for translations with the I18N_NOOP() macro.
.PP
Example: 
.PP
.nf
 setLicenseText( I18N_NOOP('This is my license'));

.fi
.PP
.PP
NOTE: No copy of the text is made.
.PP
\fBParameters:\fP
.RS 4
\fIlicense\fP The license text in utf8 encoding. 
.RE
.PP

.PP
Definition at line 156 of file kaboutdata.cpp.
.SS "void KAboutData::setLicenseTextFile (const \fBQString\fP & file)"
.PP
Defines a license text. 
.PP
\fBParameters:\fP
.RS 4
\fIfile\fP File containing the license text. 
.RE
.PP

.PP
Definition at line 163 of file kaboutdata.cpp.
.SS "void KAboutData::setAppName (const char * appName)"
.PP
Defines the program name used internally. 
.PP
\fBParameters:\fP
.RS 4
\fIappName\fP The application name. Example: 'kate'. 
.RE
.PP

.PP
Definition at line 170 of file kaboutdata.cpp.
.PP
References appName().
.SS "void KAboutData::setProgramName (const char * programName)"
.PP
Defines the displayable program name string. 
.PP
\fBParameters:\fP
.RS 4
\fIprogramName\fP The program name. This string should be marked for translation. Example: I18N_NOOP('Advanced Text Editor'). 
.RE
.PP

.PP
Definition at line 176 of file kaboutdata.cpp.
.PP
References programName().
.SS "void KAboutData::setProgramLogo (const \fBQImage\fP & image)"
.PP
Defines the program logo. 
.PP
Use this if you need to have application logo in AboutData other than application icon.
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP logo image. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBprogramLogo()\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.PP
Definition at line 260 of file kaboutdata.cpp.
.SS "void KAboutData::setVersion (const char * version)"
.PP
Defines the program version string. 
.PP
\fBParameters:\fP
.RS 4
\fIversion\fP The program version. 
.RE
.PP

.PP
Definition at line 182 of file kaboutdata.cpp.
.PP
References version().
.SS "void KAboutData::setShortDescription (const char * shortDescription)"
.PP
Defines a short description of what the program does. 
.PP
\fBParameters:\fP
.RS 4
\fIshortDescription\fP The program description This string should be marked for translation. Example: I18N_NOOP('An advanced text editor with syntax highlithing support.'). 
.RE
.PP

.PP
Definition at line 188 of file kaboutdata.cpp.
.PP
References shortDescription().
.SS "void KAboutData::setLicense (\fBLicenseKey\fP licenseKey)"
.PP
Defines the license identifier. 
.PP
\fBParameters:\fP
.RS 4
\fIlicenseKey\fP The license identifier. 
.RE
.PP

.PP
Definition at line 194 of file kaboutdata.cpp.
.SS "void KAboutData::setCopyrightStatement (const char * copyrightStatement)"
.PP
Defines the copyright statement to show when displaying the license. 
.PP
\fBParameters:\fP
.RS 4
\fIcopyrightStatement\fP A copyright statement, that can look like this: '(c) 1999-2000, Name'. The string specified here is not modified in any manner. The author information from addAuthor is not used. 
.RE
.PP

.PP
Definition at line 200 of file kaboutdata.cpp.
.PP
References copyrightStatement().
.SS "void KAboutData::setOtherText (const char * otherText)"
.PP
Defines the additional text to show in the about dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIotherText\fP Some free form text, that can contain any kind of information. The text can contain newlines. This string should be marked for translation. 
.RE
.PP

.PP
Definition at line 206 of file kaboutdata.cpp.
.PP
References otherText().
.SS "void KAboutData::setHomepage (const char * homepage)"
.PP
Defines the program homepage. 
.PP
\fBParameters:\fP
.RS 4
\fIhomepage\fP The program homepage string. Start the address with 'http://'. 'http://kate.kde.org' is is correct, 'kde.kde.org' is not. 
.RE
.PP

.PP
Definition at line 212 of file kaboutdata.cpp.
.PP
References homepage().
.SS "void KAboutData::setBugAddress (const char * bugAddress)"
.PP
Defines the address where bug reports should be sent. 
.PP
\fBParameters:\fP
.RS 4
\fIbugAddress\fP The bug report email address string. This defaults to the kde.org bug system. 
.RE
.PP

.PP
Definition at line 218 of file kaboutdata.cpp.
.PP
References bugAddress().
.SS "void KAboutData::setProductName (const char * name)"
.PP
Defines the product name wich will be used in the \fBKBugReport\fP dialog. 
.PP
By default it's the appName, but you can overwrite it here to provide support for special components e.g. 'product/component' like 'kontact/summary'.
.PP
\fBParameters:\fP
.RS 4
\fIname\fP The name of product 
.RE
.PP

.PP
Definition at line 224 of file kaboutdata.cpp.
.PP
References productName().
.SS "const char * KAboutData::appName () const"
.PP
Returns the application's internal name. 
.PP
\fBReturns:\fP
.RS 4
the internal program name. 
.RE
.PP

.PP
Definition at line 230 of file kaboutdata.cpp.
.PP
Referenced by KCmdLineArgs::init(), KAboutData(), productName(), setAppName(), and KUniqueApplication::start().
.SS "const char * KAboutData::productName () const"
.PP
Returns the application's product name, which will be used in \fBKBugReport\fP dialog. 
.PP
By default it returns \fBappName()\fP, otherwise the one which is set with \fBsetProductName()\fP
.PP
\fBReturns:\fP
.RS 4
the product name. 
.RE
.PP

.PP
Definition at line 236 of file kaboutdata.cpp.
.PP
References appName().
.PP
Referenced by setProductName().
.SS "\fBQString\fP KAboutData::programName () const"
.PP
Returns the translated program name. 
.PP
\fBReturns:\fP
.RS 4
the program name (translated). 
.RE
.PP

.PP
Definition at line 245 of file kaboutdata.cpp.
.PP
Referenced by KApplication::caption(), KCrash::defaultCrashHandler(), and setProgramName().
.SS "\fBQImage\fP KAboutData::programLogo () const"
.PP
Returns the program logo image. 
.PP
\fBReturns:\fP
.RS 4
the program logo data or null image if there is no custom application logo defined. 
.RE
.PP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.PP
Definition at line 254 of file kaboutdata.cpp.
.SS "\fBQString\fP KAboutData::version () const"
.PP
Returns the program's version. 
.PP
\fBReturns:\fP
.RS 4
the version string. 
.RE
.PP

.PP
Definition at line 269 of file kaboutdata.cpp.
.PP
References QString::fromLatin1().
.PP
Referenced by KCrash::defaultCrashHandler(), and setVersion().
.SS "\fBQString\fP KAboutData::shortDescription () const"
.PP
Returns a short, translated description. 
.PP
\fBReturns:\fP
.RS 4
the short description (translated). Can be QString::null if not set. 
.RE
.PP

.PP
Definition at line 275 of file kaboutdata.cpp.
.PP
Referenced by setShortDescription(), and KCmdLineArgs::usage().
.SS "\fBQString\fP KAboutData::homepage () const"
.PP
Returns the application homepage. 
.PP
\fBReturns:\fP
.RS 4
the application homepage URL. Can be QString::null if not set. 
.RE
.PP

.PP
Definition at line 284 of file kaboutdata.cpp.
.PP
References QString::fromLatin1().
.PP
Referenced by setHomepage().
.SS "\fBQString\fP KAboutData::bugAddress () const"
.PP
Returns the email address for bugs. 
.PP
\fBReturns:\fP
.RS 4
the email address where to report bugs. 
.RE
.PP

.PP
Definition at line 290 of file kaboutdata.cpp.
.PP
References QString::fromLatin1().
.PP
Referenced by KCrash::defaultCrashHandler(), and setBugAddress().
.SS "const \fBQValueList\fP< \fBKAboutPerson\fP > KAboutData::authors () const"
.PP
Returns a list of authors. 
.PP
\fBReturns:\fP
.RS 4
author information (list of persons). 
.RE
.PP

.PP
Definition at line 296 of file kaboutdata.cpp.
.SS "const \fBQValueList\fP< \fBKAboutPerson\fP > KAboutData::credits () const"
.PP
Returns a list of persons who contributed. 
.PP
\fBReturns:\fP
.RS 4
credit information (list of persons). 
.RE
.PP

.PP
Definition at line 302 of file kaboutdata.cpp.
.SS "const \fBQValueList\fP< \fBKAboutTranslator\fP > KAboutData::translators () const"
.PP
Returns a list of translators. 
.PP
\fBReturns:\fP
.RS 4
translators information (list of persons) 
.RE
.PP

.PP
Definition at line 308 of file kaboutdata.cpp.
.PP
References QValueList::append(), QString::fromUtf8(), QStringList::split(), and QString::stripWhiteSpace().
.SS "\fBQString\fP KAboutData::aboutTranslationTeam ()\fC [static]\fP"
.PP
Returns a message about the translation team. 
.PP
\fBReturns:\fP
.RS 4
a message about the translation team 
.RE
.PP

.PP
Definition at line 357 of file kaboutdata.cpp.
.SS "\fBQString\fP KAboutData::otherText () const"
.PP
Returns a translated, free form text. 
.PP
\fBReturns:\fP
.RS 4
the free form text (translated). Can be QString::null if not set. 
.RE
.PP

.PP
Definition at line 367 of file kaboutdata.cpp.
.PP
Referenced by setOtherText().
.SS "\fBQString\fP KAboutData::license () const"
.PP
Returns the license. 
.PP
If the licenseType argument of the constructor has been used, any text defined by setLicenseText is ignored, and the standard text for the chosen license will be returned.
.PP
\fBReturns:\fP
.RS 4
The license text. 
.RE
.PP

.PP
Definition at line 377 of file kaboutdata.cpp.
.PP
References QString::arg(), copyrightStatement(), QFile::decodeName(), QString::isEmpty(), QFile::open(), and QTextStream::read().
.SS "\fBQString\fP KAboutData::copyrightStatement () const"
.PP
Returns the copyright statement. 
.PP
\fBReturns:\fP
.RS 4
the copyright statement. Can be QString::null if not set. 
.RE
.PP

.PP
Definition at line 440 of file kaboutdata.cpp.
.PP
Referenced by license(), and setCopyrightStatement().

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