libkpimidentities

Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Friends | List of all members
KPIM::Identity Class Reference

#include <identity.h>

Public Types

typedef TQValueList< Identity > List
 

Public Member Functions

bool operator== (const Identity &other) const
 
bool operator!= (const Identity &other) const
 
bool operator< (const Identity &other) const
 
bool operator> (const Identity &other) const
 
bool operator<= (const Identity &other) const
 
bool operator>= (const Identity &other) const
 
 Identity (const TQString &id=TQString(), const TQString &realName=TQString(), const TQString &emailAddr=TQString(), const TQString &organization=TQString(), const TQString &replyToAddress=TQString())
 
 ~Identity ()
 
bool mailingAllowed () const
 
TQString identityName () const
 
void setIdentityName (const TQString &name)
 
bool isDefault () const
 
uint uoid () const
 
TQString fullName () const
 
void setFullName (const TQString &)
 
TQString organization () const
 
void setOrganization (const TQString &)
 
TDE_DEPRECATED TQCString pgpIdentity () const
 
TDE_DEPRECATED void setPgpIdentity (const TQCString &key)
 
TQCString pgpEncryptionKey () const
 
void setPGPEncryptionKey (const TQCString &key)
 
TQCString pgpSigningKey () const
 
void setPGPSigningKey (const TQCString &key)
 
TQCString smimeEncryptionKey () const
 
void setSMIMEEncryptionKey (const TQCString &key)
 
TQCString smimeSigningKey () const
 
void setSMIMESigningKey (const TQCString &key)
 
Kleo::CryptoMessageFormat preferredCryptoMessageFormat () const
 
void setPreferredCryptoMessageFormat (Kleo::CryptoMessageFormat format)
 
TDE_DEPRECATED TQString emailAddr () const
 
TDE_DEPRECATED void setEmailAddr (const TQString &email)
 
TQString primaryEmailAddress () const
 
void setPrimaryEmailAddress (const TQString &email)
 
const TQStringList & emailAliases () const
 
void setEmailAliases (const TQStringList &)
 
bool matchesEmailAddress (const TQString &addr) const
 
TQString vCardFile () const
 
void setVCardFile (const TQString &)
 
TQString fullEmailAddr () const
 
TQString replyToAddr () const
 
void setReplyToAddr (const TQString &)
 
TQString bcc () const
 
void setBcc (const TQString &aBcc)
 
void setSignature (const Signature &sig)
 
Signature & signature ()
 
const Signature & signature () const
 
TQString signatureText (bool *ok=0) const
 
TQString transport () const
 
void setTransport (const TQString &)
 
TQString fcc () const
 
void setFcc (const TQString &)
 
TQString drafts () const
 
void setDrafts (const TQString &)
 
TQString templates () const
 
void setTemplates (const TQString &)
 
TQString dictionary () const
 
void setDictionary (const TQString &)
 
TQString xface () const
 
void setXFace (const TQString &)
 
bool isXFaceEnabled () const
 
void setXFaceEnabled (const bool)
 
bool isNull () const
 

Static Public Member Functions

static const Identity & null ()
 

Protected Member Functions

void readConfig (const TDEConfigBase *)
 
void writeConfig (TDEConfigBase *) const
 
void setIsDefault (bool flag)
 
void setUoid (uint aUoid)
 
bool signatureIsCommand () const
 
bool signatureIsPlainFile () const
 
bool signatureIsInline () const
 
TQString signatureFile () const
 
void setSignatureFile (const TQString &)
 
TQString signatureInlineText () const
 
void setSignatureInlineText (const TQString &)
 
bool useSignatureFile () const
 

Protected Attributes

uint mUoid
 
TQString mIdentity
 
TQString mFullName
 
TQString mEmailAddr
 
TQString mOrganization
 
TQStringList mEmailAliases
 
TQString mReplyToAddr
 
TQString mBcc
 
TQString mVCardFile
 
TQCString mPGPEncryptionKey
 
TQCString mPGPSigningKey
 
TQCString mSMIMEEncryptionKey
 
TQCString mSMIMESigningKey
 
TQString mFcc
 
TQString mDrafts
 
TQString mTemplates
 
TQString mTransport
 
TQString mDictionary
 
TQString mXFace
 
bool mXFaceEnabled
 
Signature mSignature
 
bool mIsDefault
 
Kleo::CryptoMessageFormat mPreferredCryptoMessageFormat
 

Friends

class IdentityManager
 
TQDataStream & operator<< (TQDataStream &stream, const KPIM::Identity &ident)
 
TQDataStream & operator>> (TQDataStream &stream, KPIM::Identity &ident)
 

Detailed Description

User identity information.

Definition at line 95 of file identity.h.

Member Typedef Documentation

◆ List

typedef TQValueList<Identity> KPIM::Identity::List

Definition at line 106 of file identity.h.

Constructor & Destructor Documentation

◆ Identity()

Identity::Identity ( const TQString &  id = TQString(),
const TQString &  realName = TQString(),
const TQString &  emailAddr = TQString(),
const TQString &  organization = TQString(),
const TQString &  replyToAddress = TQString() 
)
explicit

Constructor.

Definition at line 295 of file identity.cpp.

◆ ~Identity()

Identity::~Identity ( )

Destructor.

Definition at line 313 of file identity.cpp.

Member Function Documentation

◆ bcc()

TQString KPIM::Identity::bcc ( ) const
inline

email addresses for the BCC: field

Definition at line 242 of file identity.h.

◆ dictionary()

TQString KPIM::Identity::dictionary ( ) const
inline

dictionary which should be used for spell checking

Definition at line 297 of file identity.h.

◆ drafts()

TQString KPIM::Identity::drafts ( ) const
inline

The folder where draft messages from this identity will be stored by default.

Definition at line 288 of file identity.h.

◆ emailAddr()

TDE_DEPRECATED TQString KPIM::Identity::emailAddr ( ) const
inline

email address (without the user name - only name@host)

Definition at line 215 of file identity.h.

◆ emailAliases()

const TQStringList & KPIM::Identity::emailAliases ( ) const
inline

email address aliases

Definition at line 224 of file identity.h.

◆ fcc()

TQString KPIM::Identity::fcc ( ) const
inline

The folder where sent messages from this identity will be stored by default.

Definition at line 283 of file identity.h.

◆ fullEmailAddr()

TQString Identity::fullEmailAddr ( void  ) const

email address in the format "username <name@host>" suitable for the "From:" field of email messages.

Definition at line 522 of file identity.cpp.

◆ fullName()

TQString KPIM::Identity::fullName ( ) const
inline

Full name of the user.

Definition at line 182 of file identity.h.

◆ identityName()

TQString KPIM::Identity::identityName ( ) const
inline

Identity/nickname for this collection.

Definition at line 157 of file identity.h.

◆ isDefault()

bool KPIM::Identity::isDefault ( ) const
inline
Returns
whether this identity is the default identity

Definition at line 161 of file identity.h.

◆ isNull()

bool Identity::isNull ( ) const

Definition at line 236 of file identity.cpp.

◆ isXFaceEnabled()

bool KPIM::Identity::isXFaceEnabled ( ) const
inline

Definition at line 303 of file identity.h.

◆ mailingAllowed()

bool Identity::mailingAllowed ( ) const

Tests if there are enough values set to allow mailing.

Definition at line 438 of file identity.cpp.

◆ matchesEmailAddress()

bool Identity::matchesEmailAddress ( const TQString &  addr) const

Definition at line 503 of file identity.cpp.

◆ null()

const Identity & Identity::null ( )
static

Definition at line 229 of file identity.cpp.

◆ operator!=()

bool KPIM::Identity::operator!= ( const Identity &  other) const
inline

Definition at line 111 of file identity.h.

◆ operator<()

bool KPIM::Identity::operator< ( const Identity &  other) const
inline

used for sorting

Definition at line 116 of file identity.h.

◆ operator<=()

bool KPIM::Identity::operator<= ( const Identity &  other) const
inline

Definition at line 126 of file identity.h.

◆ operator==()

bool Identity::operator== ( const Identity &  other) const

used for comparison

Definition at line 250 of file identity.cpp.

◆ operator>()

bool KPIM::Identity::operator> ( const Identity &  other) const
inline

Definition at line 121 of file identity.h.

◆ operator>=()

bool KPIM::Identity::operator>= ( const Identity &  other) const
inline

Definition at line 129 of file identity.h.

◆ organization()

TQString KPIM::Identity::organization ( ) const
inline

The user's organization (optional)

Definition at line 186 of file identity.h.

◆ pgpEncryptionKey()

TQCString KPIM::Identity::pgpEncryptionKey ( ) const
inline

The user's OpenPGP encryption key.

Definition at line 196 of file identity.h.

◆ pgpIdentity()

TDE_DEPRECATED TQCString KPIM::Identity::pgpIdentity ( ) const
inline

Definition at line 189 of file identity.h.

◆ pgpSigningKey()

TQCString KPIM::Identity::pgpSigningKey ( ) const
inline

The user's OpenPGP signing key.

Definition at line 200 of file identity.h.

◆ preferredCryptoMessageFormat()

Kleo::CryptoMessageFormat KPIM::Identity::preferredCryptoMessageFormat ( ) const
inline

Definition at line 211 of file identity.h.

◆ primaryEmailAddress()

TQString KPIM::Identity::primaryEmailAddress ( ) const
inline

primary email address (without the user name - only name@host).

The primary email address is used for all outgoing mail.

Definition at line 220 of file identity.h.

◆ readConfig()

void Identity::readConfig ( const TDEConfigBase *  config)
protected

Read configuration from config.

Group must be preset (or use TDEConfigGroup). Called from IdentityManager.

Definition at line 318 of file identity.cpp.

◆ replyToAddr()

TQString KPIM::Identity::replyToAddr ( ) const
inline

email address for the ReplyTo: field

Definition at line 238 of file identity.h.

◆ setBcc()

void KPIM::Identity::setBcc ( const TQString &  aBcc)
inline

Definition at line 243 of file identity.h.

◆ setDictionary()

void Identity::setDictionary ( const TQString &  str)

Definition at line 606 of file identity.cpp.

◆ setDrafts()

void Identity::setDrafts ( const TQString &  str)

Definition at line 590 of file identity.cpp.

◆ setEmailAddr()

TDE_DEPRECATED void KPIM::Identity::setEmailAddr ( const TQString &  email)
inline

Definition at line 216 of file identity.h.

◆ setEmailAliases()

void Identity::setEmailAliases ( const TQStringList &  list)

Definition at line 498 of file identity.cpp.

◆ setFcc()

void Identity::setFcc ( const TQString &  str)

Definition at line 582 of file identity.cpp.

◆ setFullName()

void Identity::setFullName ( const TQString &  str)

Definition at line 452 of file identity.cpp.

◆ setIdentityName()

void Identity::setIdentityName ( const TQString &  name)

Definition at line 448 of file identity.cpp.

◆ setIsDefault()

void Identity::setIsDefault ( bool  flag)
protected

Set whether this identity is the default identity.

Since this affects all other identites, too (most notably, the old default identity), only the IdentityManager can change this. You should use 

kmkernel->identityManager()->setAsDefault( name_of_default )

instead.

Definition at line 444 of file identity.cpp.

◆ setOrganization()

void Identity::setOrganization ( const TQString &  str)

Definition at line 459 of file identity.cpp.

◆ setPGPEncryptionKey()

void Identity::setPGPEncryptionKey ( const TQCString &  key)

Definition at line 471 of file identity.cpp.

◆ setPgpIdentity()

TDE_DEPRECATED void KPIM::Identity::setPgpIdentity ( const TQCString &  key)
inline

Definition at line 190 of file identity.h.

◆ setPGPSigningKey()

void Identity::setPGPSigningKey ( const TQCString &  key)

Definition at line 464 of file identity.cpp.

◆ setPreferredCryptoMessageFormat()

void KPIM::Identity::setPreferredCryptoMessageFormat ( Kleo::CryptoMessageFormat  format)
inline

Definition at line 212 of file identity.h.

◆ setPrimaryEmailAddress()

void Identity::setPrimaryEmailAddress ( const TQString &  email)

Definition at line 493 of file identity.cpp.

◆ setReplyToAddr()

void Identity::setReplyToAddr ( const TQString &  str)

Definition at line 553 of file identity.cpp.

◆ setSignature()

void KPIM::Identity::setSignature ( const Signature &  sig)
inline

Definition at line 245 of file identity.h.

◆ setSignatureFile()

void Identity::setSignatureFile ( const TQString &  str)
protected

Definition at line 560 of file identity.cpp.

◆ setSignatureInlineText()

void Identity::setSignatureInlineText ( const TQString &  str)
protected

Definition at line 567 of file identity.cpp.

◆ setSMIMEEncryptionKey()

void Identity::setSMIMEEncryptionKey ( const TQCString &  key)

Definition at line 485 of file identity.cpp.

◆ setSMIMESigningKey()

void Identity::setSMIMESigningKey ( const TQCString &  key)

Definition at line 478 of file identity.cpp.

◆ setTemplates()

void Identity::setTemplates ( const TQString &  str)

Definition at line 598 of file identity.cpp.

◆ setTransport()

void Identity::setTransport ( const TQString &  str)

Definition at line 574 of file identity.cpp.

◆ setUoid()

void KPIM::Identity::setUoid ( uint  aUoid)
inlineprotected

Definition at line 178 of file identity.h.

◆ setVCardFile()

void Identity::setVCardFile ( const TQString &  str)

Definition at line 515 of file identity.cpp.

◆ setXFace()

void Identity::setXFace ( const TQString &  str)

Definition at line 615 of file identity.cpp.

◆ setXFaceEnabled()

void Identity::setXFaceEnabled ( const bool  on)

Definition at line 625 of file identity.cpp.

◆ signature() [1/2]

Signature & KPIM::Identity::signature ( )
inline

Definition at line 246 of file identity.h.

◆ signature() [2/2]

const Signature & KPIM::Identity::signature ( ) const
inline

Definition at line 247 of file identity.h.

◆ signatureFile()

TQString KPIM::Identity::signatureFile ( ) const
inlineprotected

name of the signature file (with path)

Definition at line 258 of file identity.h.

◆ signatureInlineText()

TQString KPIM::Identity::signatureInlineText ( ) const
inlineprotected

inline signature

Definition at line 262 of file identity.h.

◆ signatureIsCommand()

bool KPIM::Identity::signatureIsCommand ( ) const
inlineprotected
Returns
true if the signature is read from the output of a command

Definition at line 251 of file identity.h.

◆ signatureIsInline()

bool KPIM::Identity::signatureIsInline ( ) const
inlineprotected
Returns
true if the signature was specified directly

Definition at line 255 of file identity.h.

◆ signatureIsPlainFile()

bool KPIM::Identity::signatureIsPlainFile ( ) const
inlineprotected
Returns
true if the signature is read from a text file

Definition at line 253 of file identity.h.

◆ signatureText()

TQString Identity::signatureText ( bool *  ok = 0) const

Returns the signature.

This method also takes care of special signature files that are shell scripts and handles them correct. So use this method to rectreive the contents of the signature file. If prompt is false, no errors will be displayed (useful for retries).

Definition at line 632 of file identity.cpp.

◆ smimeEncryptionKey()

TQCString KPIM::Identity::smimeEncryptionKey ( ) const
inline

The user's S/MIME encryption key.

Definition at line 204 of file identity.h.

◆ smimeSigningKey()

TQCString KPIM::Identity::smimeSigningKey ( ) const
inline

The user's S/MIME signing key.

Definition at line 208 of file identity.h.

◆ templates()

TQString KPIM::Identity::templates ( ) const
inline

The folder where template messages from this identity will be stored by default.

Definition at line 293 of file identity.h.

◆ transport()

TQString KPIM::Identity::transport ( ) const
inline

The transport that is set for this identity.

Used to link a transport with an identity.

Definition at line 278 of file identity.h.

◆ uoid()

uint KPIM::Identity::uoid ( ) const
inline

Unique Object Identifier for this identity.

Definition at line 164 of file identity.h.

◆ useSignatureFile()

bool KPIM::Identity::useSignatureFile ( ) const
inlineprotected

Inline or signature from a file.

Definition at line 266 of file identity.h.

◆ vCardFile()

TQString KPIM::Identity::vCardFile ( ) const
inline

vCard to attach to outgoing emails

Definition at line 230 of file identity.h.

◆ writeConfig()

void Identity::writeConfig ( TDEConfigBase *  config) const
protected

Write configuration to config.

Group must be preset (or use TDEConfigGroup). Called from IdentityManager.

Definition at line 355 of file identity.cpp.

◆ xface()

TQString KPIM::Identity::xface ( ) const
inline

a X-Face header for this identity

Definition at line 301 of file identity.h.

Friends And Related Function Documentation

◆ IdentityManager

friend class IdentityManager
friend

Definition at line 100 of file identity.h.

Member Data Documentation

◆ mBcc

TQString KPIM::Identity::mBcc
protected

Definition at line 317 of file identity.h.

◆ mDictionary

TQString KPIM::Identity::mDictionary
protected

Definition at line 321 of file identity.h.

◆ mDrafts

TQString KPIM::Identity::mDrafts
protected

Definition at line 320 of file identity.h.

◆ mEmailAddr

TQString KPIM::Identity::mEmailAddr
protected

Definition at line 314 of file identity.h.

◆ mEmailAliases

TQStringList KPIM::Identity::mEmailAliases
protected

Definition at line 315 of file identity.h.

◆ mFcc

TQString KPIM::Identity::mFcc
protected

Definition at line 320 of file identity.h.

◆ mFullName

TQString KPIM::Identity::mFullName
protected

Definition at line 314 of file identity.h.

◆ mIdentity

TQString KPIM::Identity::mIdentity
protected

Definition at line 314 of file identity.h.

◆ mIsDefault

bool KPIM::Identity::mIsDefault
protected

Definition at line 325 of file identity.h.

◆ mOrganization

TQString KPIM::Identity::mOrganization
protected

Definition at line 314 of file identity.h.

◆ mPGPEncryptionKey

TQCString KPIM::Identity::mPGPEncryptionKey
protected

Definition at line 319 of file identity.h.

◆ mPGPSigningKey

TQCString KPIM::Identity::mPGPSigningKey
protected

Definition at line 319 of file identity.h.

◆ mPreferredCryptoMessageFormat

Kleo::CryptoMessageFormat KPIM::Identity::mPreferredCryptoMessageFormat
protected

Definition at line 326 of file identity.h.

◆ mReplyToAddr

TQString KPIM::Identity::mReplyToAddr
protected

Definition at line 316 of file identity.h.

◆ mSignature

Signature KPIM::Identity::mSignature
protected

Definition at line 324 of file identity.h.

◆ mSMIMEEncryptionKey

TQCString KPIM::Identity::mSMIMEEncryptionKey
protected

Definition at line 319 of file identity.h.

◆ mSMIMESigningKey

TQCString KPIM::Identity::mSMIMESigningKey
protected

Definition at line 319 of file identity.h.

◆ mTemplates

TQString KPIM::Identity::mTemplates
protected

Definition at line 320 of file identity.h.

◆ mTransport

TQString KPIM::Identity::mTransport
protected

Definition at line 320 of file identity.h.

◆ mUoid

uint KPIM::Identity::mUoid
protected

Definition at line 313 of file identity.h.

◆ mVCardFile

TQString KPIM::Identity::mVCardFile
protected

Definition at line 318 of file identity.h.

◆ mXFace

TQString KPIM::Identity::mXFace
protected

Definition at line 322 of file identity.h.

◆ mXFaceEnabled

bool KPIM::Identity::mXFaceEnabled
protected

Definition at line 323 of file identity.h.

The documentation for this class was generated from the following files: