• Skip to content
  • Skip to link menu
Trinity API Reference
  • Trinity API Reference
  • tdecore
 

tdecore

  • tdecore
tdeaboutdata.h
1 /*
2  * This file is part of the KDE Libraries
3  * Copyright (C) 2000 Espen Sand (espen@kde.org)
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Library General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  * Library General Public License for more details.
14  *
15  * You should have received a copy of the GNU Library General Public License
16  * along with this library; see the file COPYING.LIB. If not, write to
17  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18  * Boston, MA 02110-1301, USA.
19  *
20  */
21 
22 #include <tqvaluelist.h>
23 #include <tqstring.h>
24 #include <tqimage.h>
25 #include <tdelocale.h>
26 
27 #ifndef _TDEABOUTDATA_H_
28 #define _TDEABOUTDATA_H_
29 
30 class TDEAboutPersonPrivate;
31 class TDEAboutDataPrivate;
32 
54 class TDECORE_EXPORT TDEAboutPerson
55 {
56 public:
70  TDEAboutPerson( const char *name, const char *task,
71  const char *emailAddress, const char *webAddress )
72  {
73  mName = name;
74  mTask = task;
75  mEmailAddress = emailAddress;
76  mWebAddress = webAddress;
77  }
82  TDEAboutPerson() {}
83 
89  TQString name() const;
90 
96  TQString task() const;
97 
103  TQString emailAddress() const;
104 
110  TQString webAddress() const;
111 
112 private:
113  const char *mName;
114  const char *mTask;
115  const char *mEmailAddress;
116  const char *mWebAddress;
117 
118  TDEAboutPersonPrivate *d;
119 };
120 
121 class TDEAboutTranslatorPrivate;
134 class TDECORE_EXPORT TDEAboutTranslator
135 {
136 public:
144  TDEAboutTranslator(const TQString & name=TQString::null,
145  const TQString & emailAddress=TQString::null);
146 
152  TQString name() const;
153 
159  TQString emailAddress() const;
160 
161 private:
162  TQString mName;
163  TQString mEmail;
164  TDEAboutTranslatorPrivate* d;
165 };
166 
167 
182 class TDECORE_EXPORT TDEAboutData
183 {
184  public:
188  enum LicenseKey
189  {
190  License_Custom = -2,
191  License_File = -1,
192  License_Unknown = 0,
193  License_GPL = 1,
194  License_GPL_V2 = 1,
195  License_LGPL = 2,
196  License_LGPL_V2 = 2,
197  License_BSD = 3,
198  License_Artistic = 4,
199  License_QPL = 5,
200  License_QPL_V1_0 = 5,
201  License_GPL_V3 = 6,
202  License_LGPL_V3 = 7
203  };
204 
205  public:
240  TDEAboutData( const char *appName,
241  const char *programName,
242  const char *version,
243  const char *shortDescription = 0,
244  int licenseType = License_Unknown,
245  const char *copyrightStatement = 0,
246  const char *text = 0,
247  const char *homePageAddress = 0,
248  const char *bugsEmailAddress = 0
249  );
250 
251  ~TDEAboutData();
252 
272  void addAuthor( const char *name,
273  const char *task=0,
274  const char *emailAddress=0,
275  const char *webAddress=0 );
276 
296  void addCredit( const char *name,
297  const char *task=0,
298  const char *emailAddress=0,
299  const char *webAddress=0 );
300 
325  void setTranslator(const char* name, const char* emailAddress);
326 
342  void setLicenseText( const char *license );
343 
349  void setLicenseTextFile( const TQString &file );
350 
356  void setAppName( const char *appName );
357 
366  void setProgramName( const char* programName );
367 
377  void setProgramLogo(const TQImage& image);
378 
384  void setVersion( const char* version );
385 
393  void setShortDescription( const char *shortDescription );
394 
400  void setLicense( LicenseKey licenseKey);
401 
410  void setCopyrightStatement( const char *copyrightStatement );
411 
419  void setOtherText( const char *otherText );
420 
428  void setHomepage( const char *homepage );
429 
436  void setBugAddress( const char *bugAddress );
437 
446  void setProductName( const char *name );
447 
452  const char *appName() const;
453 
461  const char *productName() const;
462 
467  TQString programName() const;
468 
472  const char* internalProgramName() const;
476  void translateInternalProgramName() const;
477 
484  TQImage programLogo() const;
485 
490  TQString version() const;
491 
495  const char* internalVersion() const { return mVersion; }
496 
502  TQString shortDescription() const;
503 
509  TQString homepage() const;
510 
515  TQString bugAddress() const;
516 
520  const char* internalBugAddress() const { return mBugEmailAddress; }
521 
526  const TQValueList<TDEAboutPerson> authors() const;
527 
532  const TQValueList<TDEAboutPerson> credits() const;
533 
538  const TQValueList<TDEAboutTranslator> translators() const;
539 
544  static TQString aboutTranslationTeam();
545 
550  TQString otherText() const;
551 
559  TQString license() const;
560 
565  TQString copyrightStatement() const;
566 
574  TQString customAuthorPlainText() const;
575 
583  TQString customAuthorRichText() const;
584 
592  bool customAuthorTextEnabled() const;
593 
604  void setCustomAuthorText(const TQString &plainText, const TQString &richText);
605 
611  void unsetCustomAuthorText();
612 
613  private:
614  const char *mAppName;
615  const char *mProgramName;
616  const char *mVersion;
617  const char *mShortDescription;
618  int mLicenseKey;
619  const char *mCopyrightStatement;
620  const char *mOtherText;
621  const char *mHomepageAddress;
622  const char *mBugEmailAddress;
623  TQValueList<TDEAboutPerson> mAuthorList;
624  TQValueList<TDEAboutPerson> mCreditList;
625  const char *mLicenseText;
626  static const char *defaultBugTracker;
627 
628  TDEAboutDataPrivate *d;
629 };
630 
631 #endif
632 
TDEAboutData::LicenseKey
LicenseKey
Descibes the license of the software.
Definition: tdeaboutdata.h:188
TDEAboutData
This class is used to store information about a program.
Definition: tdeaboutdata.h:182
TDEAboutTranslator
This structure is used to store information about a translator.
Definition: tdeaboutdata.h:134
tdelocale.h
KStdAction::name
const char * name(StdAction id)
TDEAboutPerson
This structure is used to store information about a person or developer.
Definition: tdeaboutdata.h:54
TDEAboutPerson::TDEAboutPerson
TDEAboutPerson(const char *name, const char *task, const char *emailAddress, const char *webAddress)
Convenience constructor.
Definition: tdeaboutdata.h:70

tdecore

Skip menu "tdecore"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

tdecore

Skip menu "tdecore"
  • arts
  • dcop
  • dnssd
  • interfaces
  •   kspeech
  •     interface
  •     library
  •   tdetexteditor
  • kate
  • kded
  • kdoctools
  • kimgio
  • kjs
  • libtdemid
  • libtdescreensaver
  •     tdecore
  • tdeabc
  • tdecmshell
  • tdecore
  • tdefx
  • tdehtml
  • tdeinit
  • tdeio
  •   bookmarks
  •   httpfilter
  •   kpasswdserver
  •   kssl
  • tdeioslave
  •   http
  •   tdefile
  •   tdeio
  •   tdeioexec
  • tdemdi
  •   tdemdi
  • tdenewstuff
  • tdeparts
  • tdeprint
  • tderandr
  • tderesources
  • tdespell2
  • tdesu
  • tdeui
  • tdeunittest
  • tdeutils
  • tdewallet
Generated for tdecore by doxygen 1.8.8
This website is maintained by Timothy Pearson.