Interface representing a single account. More...

#include "iaccount.h"

Public Types
enum	AccountFeature { FRenamable = 0x01 , FSupportsXA = 0x02 , FHasConfigurationDialog = 0x04 , FCanAddContactsInOffline = 0x08 , FCanViewContactsInfoInOffline = 0x10 , FMUCsSupportFileTransfers = 0x20 }

Public Member Functions
Emitters::Account &	GetAccountEmitter ()
virtual QObject *	GetQObject ()=0
	Returns the account object as a QObject.
virtual QObject *	GetParentProtocol () const =0
	Returns the pointer to the parent protocol that this account belongs to.
virtual AccountFeatures	GetAccountFeatures () const =0
	Returns the OR-ed combination of features of this account.
virtual QList< ICLEntry * >	GetCLEntries ()=0
	Returns the list of contact list entries of this account.
virtual QString	GetAccountName () const =0
	Returns the human-readable name of this account.
virtual QString	GetOurNick () const =0
	Returns the nickname of our user.
virtual void	RenameAccount (const QString &name)=0
	Sets the human-readable name of this account to the new name.
virtual QByteArray	GetAccountID () const =0
	Returns the ID of this account.
virtual QList< QAction * >	GetActions () const =0
	Returns the list of actions for the account item.
virtual void	OpenConfigurationDialog ()=0
	Requests the account to open its configuration dialog.
virtual EntryStatus	GetState () const =0
	Returns the current status of this account.
virtual void	ChangeState (const EntryStatus &status)=0
	Sets the status of this account.
virtual void	Authorize (QObject *entry)=0
	Grants authorization to the given entry.
virtual void	DenyAuth (QObject *entry)=0
	Denies authorization for the given entry.
virtual void	RequestAuth (const QString &entry, const QString &msg=QString(), const QString &name=QString(), const QStringList &groups=QStringList())=0
	Requests authorization from the given entry.
virtual void	RemoveEntry (QObject *entry)=0
	Removes the given entry from the contact list.
virtual QObject *	GetTransferManager () const =0
	Returns the object responsible for file transfers in this account.
virtual bool	IsShownInRoster () const
	Whether the account should be shown in the roster.
virtual void	SetShownInRoster (bool shown)
	Sets whether the account should be shown in the roster.

Protected Member Functions
virtual	~IAccount ()=default

Protected Attributes
Emitters::Account	Emitter_

Detailed Description

Interface representing a single account.

This interface represents an account — an entity within IProtocol owning some ICLEntry objects.

The account may also implement IHaveServiceDiscovery if it supports some XMPP's service discovery-like functionality. Look at that documentation for more information.

If the account supports something similar to XML console, it can also implement the IHaveConsole interface.

If the account supports publishing user tune, it may implement ISupportTune.

See also: IHaveServiceDiscovery, IHaveConsole; ISupportTune, ISupportMood, ISupportActivity; ISupportGeolocation

Definition at line 45 of file iaccount.h.

Member Enumeration Documentation

◆ AccountFeature

enum LC::Azoth::IAccount::AccountFeature

Represents the features that may be supported by an acoount.

Enumerator
FRenamable	This account can be renamed, so calls to RenameAccount() would not be senseless.
FSupportsXA	This account supports Extended Away statuses.
FHasConfigurationDialog	This account has configuration dialog.
FCanAddContactsInOffline	This account can add accounts to CL while being offline.
FCanViewContactsInfoInOffline	This account supports viewing contacts information while offline.
FMUCsSupportFileTransfers	This account supports sending and receiving files to or from MUCs.

Definition at line 57 of file iaccount.h.

Constructor & Destructor Documentation

◆ ~IAccount()

virtual LC::Azoth::IAccount::~IAccount ( )

protectedvirtualdefault

Member Function Documentation

◆ Authorize()

virtual void LC::Azoth::IAccount::Authorize ( QObject * entry )

pure virtual

Grants authorization to the given entry.

entry is expected to be deleted in this function.

Parameters

[in] entry Entry object implementing ICLEntry.

References Authorize().

Referenced by Authorize().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ChangeState()

virtual void LC::Azoth::IAccount::ChangeState ( const EntryStatus & status )

pure virtual

Sets the status of this account.

If the account was offline, it is expected to connect at this point automatically.

Parameters

[in] status The new status of this account.

References ChangeState().

Referenced by ChangeState().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DenyAuth()

virtual void LC::Azoth::IAccount::DenyAuth ( QObject * entry )

pure virtual

Denies authorization for the given entry.

entry is expected to be deleted in this function.

Parameters

[in] entry Entry object implementing ICLEntry.

References DenyAuth().

Referenced by DenyAuth().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetAccountEmitter()

Emitters::Account & LC::Azoth::IAccount::GetAccountEmitter ( )

inline

Definition at line 53 of file iaccount.h.

References Emitter_.

◆ GetAccountFeatures()

virtual AccountFeatures LC::Azoth::IAccount::GetAccountFeatures ( ) const

pure virtual

Returns the OR-ed combination of features of this account.

Returns: The features of this account.

References GetAccountFeatures().

Referenced by GetAccountFeatures().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetAccountID()

virtual QByteArray LC::Azoth::IAccount::GetAccountID ( ) const

pure virtual

Returns the ID of this account.

The returned ID should be unique among all accounts and should not depend on the value of GetAccountName() (the human-readable name of the account).

Returns: The unique and persistent account ID.

References GetAccountID().

Referenced by GetAccountID().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetAccountName()

virtual QString LC::Azoth::IAccount::GetAccountName ( ) const

pure virtual

Returns the human-readable name of this account.

Returns: Human-readable name of this account.

See also: RenameAccount()

References GetAccountName().

Referenced by GetAccountName().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetActions()

virtual QList< QAction * > LC::Azoth::IAccount::GetActions ( ) const

pure virtual

Returns the list of actions for the account item.

The list is showed, for example, when user calls the context menu on the account item, or such.

Returns: The list of actions.

References GetActions().

Referenced by GetActions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetCLEntries()

virtual QList< ICLEntry * > LC::Azoth::IAccount::GetCLEntries ( )

pure virtual

Returns the list of contact list entries of this account.

Typically this would be the list of contacts added to the account plus any entries that represent multiuser chatrooms, their participants and such, if applicable.

Returns: The list of contact list entries of this account.

References GetCLEntries().

Referenced by GetCLEntries().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetOurNick()

virtual QString LC::Azoth::IAccount::GetOurNick ( ) const

pure virtual

Returns the nickname of our user.

Returns: Nickname of our user.

References GetOurNick().

Referenced by GetOurNick().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetParentProtocol()

virtual QObject * LC::Azoth::IAccount::GetParentProtocol ( ) const

pure virtual

Returns the pointer to the parent protocol that this account belongs to.

Returns: The parent protocol of this account.

References GetParentProtocol().

Referenced by GetParentProtocol().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetQObject()

virtual QObject * LC::Azoth::IAccount::GetQObject ( )

pure virtual

Returns the account object as a QObject.

Returns: Account object as QObject.

References GetQObject().

Referenced by GetQObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetState()

virtual EntryStatus LC::Azoth::IAccount::GetState ( ) const

pure virtual

Returns the current status of this account.

Returns: Current status of this account.

References GetState().

Referenced by GetState().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetTransferManager()

virtual QObject * LC::Azoth::IAccount::GetTransferManager ( ) const

pure virtual

Returns the object responsible for file transfers in this account.

If file transfers aren't supported, NULL should be returned. The returned object, is not NULL, is expected to implement ITransferManager.

Returns: The file transfer manager, or NULL if not supported.

References GetTransferManager().

Referenced by GetTransferManager().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsShownInRoster()

virtual bool LC::Azoth::IAccount::IsShownInRoster ( ) const

inlinevirtual

Whether the account should be shown in the roster.

The default implementation simply returns the value of a the return variable set by SetShownInRoster().

By default, accounts should be shown in the roster.

Returns: Whether the account should be shown in roster.

See also: SetShownInRoster()

Definition at line 265 of file iaccount.h.

References IsShownInRoster().

Referenced by IsShownInRoster().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ OpenConfigurationDialog()

virtual void LC::Azoth::IAccount::OpenConfigurationDialog ( )

pure virtual

Requests the account to open its configuration dialog.

References OpenConfigurationDialog().

Referenced by OpenConfigurationDialog().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RemoveEntry()

virtual void LC::Azoth::IAccount::RemoveEntry ( QObject * entry )

pure virtual

Removes the given entry from the contact list.

Removes the entry from the contact list and automatically synchronizes the changes in the contact list, if applicable.

If the entry could not be removed at the moment, or if the parameter is invalid, this function should do nothing.

Parameters

[in] entry The entry to remove.

References RemoveEntry().

Referenced by RemoveEntry().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RenameAccount()

virtual void LC::Azoth::IAccount::RenameAccount ( const QString & name )

pure virtual

Sets the human-readable name of this account to the new name.

Parameters

[in] name The new name of the account.

See also: GetAccountName()

References RenameAccount().

Referenced by RenameAccount().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RequestAuth()

virtual void LC::Azoth::IAccount::RequestAuth	(	const QString &	entry,
		const QString &	msg = QString(),
		const QString &	name = QString(),
		const QStringList &	groups = QStringList() )

pure virtual

Requests authorization from the given entry.

entry is a human-readable identifier of the remote, as returned by ICLEntry::GetHumanReadableID().

If applicable and msg is a non-empty string, the msg should be sent to the entry as the message sent along with the request.

name should be the name under which the entry is added to the contact list, if applicable. If name is an empty string, a sane default should be used, like the human-readable ID — entry.

groups is the list of groups that this entry is added to. If groups is an emptry list, the behavior should be defined by the plugin - the entry should either be added to some kind of default group or have no assigned groups at all. If protocol supports only one group per entry, the first one in the list should be used.

Parameters

[in]	entry	Human-readable ID of the remote.
[in]	msg	Optional request string to display to remote, if applicable.
[in]	name	The name under which the entry should be added to the contact list. May be blank.
[in]	groups	The groups to add the entry to, if applicable. May be blank.

References RequestAuth().

Referenced by RequestAuth().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetShownInRoster()

virtual void LC::Azoth::IAccount::SetShownInRoster ( bool shown )

inlinevirtual

Sets whether the account should be shown in the roster.

The default implementation simply sets the corresponding private variable that is returned from IsShownInRoster().

Calling this function does not have to result in any kind of account saving, signal emission and so on. This function (and its IsShownInRoster() counterpart) are provided solely for Azoth core convenience.

After calling this function the IsShownInRoster() method should return the last value of shown.

Parameters

[in] shown Whether the account should be shown in the roster.

See also: IsShownInRoster()

Definition at line 288 of file iaccount.h.

Member Data Documentation

◆ Emitter_

Emitters::Account LC::Azoth::IAccount::Emitter_

protected

Definition at line 49 of file iaccount.h.

Referenced by GetAccountEmitter().

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

/home/abuild/rpmbuild/BUILD/leechcraft-doc-0.6.70+git.18450.gabe19ee3b0-build/leechcraft-0.6.70-18450-gabe19ee3b0/src/plugins/azoth/interfaces/azoth/iaccount.h

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ AccountFeature

Constructor & Destructor Documentation

◆ ~IAccount()

Member Function Documentation

◆ Authorize()

◆ ChangeState()

◆ DenyAuth()

◆ GetAccountEmitter()

◆ GetAccountFeatures()

◆ GetAccountID()

◆ GetAccountName()

◆ GetActions()

◆ GetCLEntries()

◆ GetOurNick()

◆ GetParentProtocol()

◆ GetQObject()

◆ GetState()

◆ GetTransferManager()

◆ IsShownInRoster()

◆ OpenConfigurationDialog()

◆ RemoveEntry()

◆ RenameAccount()

◆ RequestAuth()

◆ SetShownInRoster()

Member Data Documentation

◆ Emitter_