MailTransport::Transport Class Reference

#include <transport.h>

Inherits TransportBase.

Public Types
using	Id = int
using	List = QList< Transport * >

Properties
QString	password
TransportType	transportType

Signals
void	passwordChanged ()
void	passwordLoaded ()
void	transportTypeChanged ()

Public Member Functions
	~Transport () override
QString	authenticationTypeString () const
Transport *	clone () const
void	forceUniqueName ()
bool	isComplete () const
Q_INVOKABLE bool	isValid () const
QString	password () const
void	setPassword (const QString &passwd)
TransportType	transportType () const
void	updatePasswordState ()

Static Public Member Functions
static QString	authenticationTypeString (int type)

Protected Member Functions
	Transport (const QString &cfgGroup)
void	migrateToWallet ()
bool	needsWalletMigration () const
void	usrRead () override
bool	usrSave () override

Detailed Description

Represents the settings of a specific mail transport.

To create a new empty Transport object, use TransportManager::createTransport().

Initialize an empty Transport object by calling the set...() methods defined in kcfg-generated TransportBase, and in this class.

Definition at line 32 of file transport.h.

Constructor & Destructor Documentation

~Transport()

Transport::~Transport ( )

overridedefault

Destructor.

Transport()

Transport::Transport ( const QString &  cfgGroup )

explicitprotected

Creates a Transport object.

Should only be used by TransportManager.

Parameters

cfgGroup

The KConfig group to read its data from.

Definition at line 26 of file transport.cpp.

Member Function Documentation

authenticationTypeString() [1/2]

QString Transport::authenticationTypeString

(

)

const

Returns a string representation of the authentication type.

Definition at line 113 of file transport.cpp.

authenticationTypeString() [2/2]

QString Transport::authenticationTypeString ( int  type )

static

Returns a string representation of the authentication type.

Convenience function when there isn't a Transport object instantiated.

Since

4.5

Definition at line 118 of file transport.cpp.

clone()

Transport * Transport::clone

(

)

const

Returns a deep copy of this Transport object which will no longer be automatically updated.

Use this if you need to store a Transport object over a longer time. However it is recommended to store transport identifiers instead if possible.

See also

updatePasswordState()

Definition at line 304 of file transport.cpp.

forceUniqueName()

void Transport::forceUniqueName

(

)

Makes sure the transport has a unique name.

Adds #1, #2, #3 etc. if necessary.

Since

4.4

Definition at line 69 of file transport.cpp.

isComplete()

bool Transport::isComplete

(

)

const

Returns true if all settings have been loaded.

This is the way to find out if the password has already been loaded from the wallet.

Definition at line 108 of file transport.cpp.

isValid()

bool Transport::isValid

(

)

const

Returns true if this transport is valid, ie.

has all necessary data set.

Definition at line 41 of file transport.cpp.

migrateToWallet()

void Transport::migrateToWallet ( )

protected

Try to migrate the password from the config file to the wallet.

Definition at line 293 of file transport.cpp.

needsWalletMigration()

bool Transport::needsWalletMigration ( ) const

protected

Returns true if the password was not stored in the wallet.

Definition at line 288 of file transport.cpp.

password()

QString MailTransport::Transport::password

(

)

const

Returns the password of this transport.

passwordChanged

void MailTransport::Transport::passwordChanged ( )

signal

Emitted when the password is changed.

passwordLoaded

void MailTransport::Transport::passwordLoaded ( )

signal

Emitted when passwords have been loaded from QKeyChain.

setPassword()

void Transport::setPassword

(

const QString &

passwd

)

Sets the password of this transport.

Parameters

passwd

The new password.

Definition at line 58 of file transport.cpp.

transportType()

TransportType MailTransport::Transport::transportType

(

)

const

Returns the type of this transport.

See also

TransportType.

Since

4.4

transportTypeChanged

void MailTransport::Transport::transportTypeChanged ( )

signal

Emitted when the transport type is changed.

updatePasswordState()

void Transport::updatePasswordState

(

)

This function synchronizes the password of this transport with the password of the transport with the same ID that is managed by the transport manager.

This is only useful for cloned transports, since their passwords don't automatically get updated when calling TransportManager::loadPasswordsAsync() or TransportManager::loadPasswords().

See also

clone()

Since

4.2

Definition at line 91 of file transport.cpp.

---

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

• transport.h
• transport.cpp