Represents a single entry in contact list. More...

#include "iclentry.h"

Public Types
enum	Feature { FPermanentEntry = 0x0000 , FSessionEntry = 0x0001 , FMaskLongetivity = 0x0003 , FSupportsRenames = 0x0020 , FHasCustomChatWidget = 0x0040 , FSupportsAuth = 0x0080 , FSupportsGrouping = 0x0100 , FSelfContact = 0x0200 }
enum class	EntryType { Chat , MUC , PrivateChat , UnauthEntry }

Public Member Functions
Emitters::CLEntry &	GetCLEntryEmitter ()
virtual QObject *	GetQObject ()=0
virtual IAccount *	GetParentAccount () const =0
virtual ICLEntry *	GetParentCLEntry () const
QObject *	GetParentCLEntryObject () const
virtual Features	GetEntryFeatures () const =0
virtual EntryType	GetEntryType () const =0
virtual QString	GetEntryName () const =0
virtual void	SetEntryName (const QString &name)=0
	Sets the human-readable name of this entry.
virtual QString	GetEntryID () const =0
	Returns the ID of this entry.
virtual QString	GetHumanReadableID () const
	Returns the human-readable ID of this entry.
virtual QStringList	Groups () const =0
	Returns the list of human-readable names of the groups that this entry belongs to.
virtual void	SetGroups (const QStringList &groups)=0
	Sets the list of groups this item belongs to.
virtual QStringList	Variants () const =0
	Returns the list of destination variants.
virtual void	SendMessage (const OutgoingMessage &message)=0
	Sends the message described by message.
virtual QList< IMessage * >	GetAllMessages () const =0
	Returns all already sent or received messages.
virtual void	PurgeMessages (const QDateTime &before)=0
	Purges messages before the given date.
virtual void	SetChatPartState (ChatPartState state, const QString &variant)=0
	Notifies about our chat participation state change.
virtual EntryStatus	GetStatus (const QString &variant=QString()) const =0
	Returns the current status of a variant of the item.
virtual void	ShowInfo ()=0
	Requests the entry to show dialog with info about it.
virtual QList< QAction * >	GetActions () const =0
	Returns the list of actions for the item.
virtual QMap< QString, QVariant >	GetClientInfo (const QString &variant) const =0
	Returns the client information for the given variant.
virtual void	MarkMsgsRead ()=0
	Called whenever new messages are read.
virtual void	ChatTabClosed ()=0
	Called by Azoth when the chat with the entry is closed.

Protected Member Functions
virtual	~ICLEntry ()=default

Protected Attributes
Emitters::CLEntry	Emitter_

Detailed Description

Represents a single entry in contact list.

Everything that should go to the contact list should implement this interface: plain contacts, metacontacts, transports to other accounts in protocols like XMPP, and such.

In some protocol an entry can have several destinations, like resources in XMPP protocol. In this case, GetVariants() should return the up-to-date list of variants that this entry may have as destinations.

By default, entries are considered to be normal chat entries, and Azoth core would manage the chat widget (and, consequently, chat tabs) for such entries itself. Nevertheless, some entries may want to have custom behavior for their widgets or even have no widgets at all. In this case, they set FHasCustomChatWidget flag in GetEntryFeatures(). In this case Azoth core wouldn't care about their chat widgets at all. Instead, such entry would need to implement IMultiTabsWidget, for example, and the corresponding plugin would need to be a IMultiTabs.

This interface provides only more or less basic functionality. Advanced features, like drawing attention and such, are in IAdvancedCLEntry.

If the CL entry can have an avatar, it makes sense to implement the IHaveAvatars interface.

See also: IAdvancedCLEntry; IHaveAvatars

Definition at line 56 of file iclentry.h.

Member Enumeration Documentation

◆ EntryType

enum class LC::Azoth::ICLEntry::EntryType

strong

Enumerator
Chat	This entry represents a standard chat.
MUC	This entry represents a multi-user chatroom.
PrivateChat	This entry represents a private conversation in a multi-user chatroom.
UnauthEntry	This entry represents an unauthorized user that has requested authorization.

Definition at line 114 of file iclentry.h.

◆ Feature

enum LC::Azoth::ICLEntry::Feature

Represents the features that may be supported by a contant list entry.

Enumerator
FPermanentEntry	This entry is permanent and would appear in the next session too. It makes sense to save it to disk, for example, when shutting down. This also means that the entry has been accepted into some kind of contact list by the user.
FSessionEntry	This entry is not permanent and would cease existing after this login session.
FMaskLongetivity	Mask (0000011) for FPermanentEntry and FSessionEntry.
FSupportsRenames	This entry supports renaming, so calls to SetEntryName() are not in vain.
FHasCustomChatWidget	This entry has a custom chat widget.
FSupportsAuth	This entry supports auth manipulations. It makes sense to request, remove, give, etc auth. In this case the entry should also implement IAuthable.
FSupportsGrouping	This entry supports moving between different groups.
FSelfContact	This entry represents a self-contact, for example, in XMPP.

Definition at line 68 of file iclentry.h.

Constructor & Destructor Documentation

◆ ~ICLEntry()

virtual LC::Azoth::ICLEntry::~ICLEntry ( )

protectedvirtualdefault

Member Function Documentation

◆ ChatTabClosed()

virtual void LC::Azoth::ICLEntry::ChatTabClosed ( )

pure virtual

Called by Azoth when the chat with the entry is closed.

◆ GetActions()

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

pure virtual

Returns the list of actions for the item.

The list is showed, for example, when user calls the context menu on the item, or such. You may want to place actions like "Info", etc, in this list.

Returns: The list of actions.

◆ GetAllMessages()

virtual QList< IMessage * > LC::Azoth::ICLEntry::GetAllMessages ( ) const

pure virtual

Returns all already sent or received messages.

Returns the list of all messages sent or received during the session.

If the entry represents a MUC, all the messages in the returned list should have "IN" direction.

Returns: The list of messages.

◆ GetCLEntryEmitter()

Emitters::CLEntry & LC::Azoth::ICLEntry::GetCLEntryEmitter ( )

inline

Definition at line 63 of file iclentry.h.

References Emitter_.

◆ GetClientInfo()

virtual QMap< QString, QVariant > LC::Azoth::ICLEntry::GetClientInfo ( const QString & variant ) const

pure virtual

Returns the client information for the given variant.

The returned map should have the following keys:

client_type The corresponding value is a QString with a client ID.
client_name The corresponding value is a QString with human-readable name of the client.
client_version The corresponding value is a QString with human-readable version of the client.
priority The corresponding value is a int with the priority of the variant. The priority spans from -1024 to 1024, with negative values indicating that the message won't be delivered to this resource unless it was explicitly created to be targeted at this resource.

Parameters

[in] variant Variant for which to return the client info.

Returns: Human-readable client name of the variant.

◆ GetEntryFeatures()

virtual Features LC::Azoth::ICLEntry::GetEntryFeatures ( ) const

pure virtual

Returns the OR-ed combination of Feature flags that describes the features supported by this contact list entry.

Returns: The features supported by this entry.

◆ GetEntryID()

virtual QString LC::Azoth::ICLEntry::GetEntryID ( ) const

pure virtual

Returns the ID of this entry.

The ID must be unique among all entries and should not depend on the value returned by GetEntryName() (the human-readable name).

The main difference between this and GetHumanReadableID() is that GetEntryID() is used for distinguishing different items in the contact list (and there may be several items for one remote), while GetHumanReadableID() is used to distinguish different remotes between each other. Also, GetEntryID() should be unique globally (for example, it may contain ID of the account in it).

Returns: The unique and persistent ID of this entry.

See also: GetHumanReadableID()

Referenced by GetHumanReadableID().

Here is the caller graph for this function:

◆ GetEntryName()

virtual QString LC::Azoth::ICLEntry::GetEntryName ( ) const

pure virtual

Returns the human-readable name of this entry.

Returns: Human-readable name of this entry.

See also: SetEntryName()

◆ GetEntryType()

virtual EntryType LC::Azoth::ICLEntry::GetEntryType ( ) const

pure virtual

Returns the type of this entry.

Returns: The type of this entry.

◆ GetHumanReadableID()

virtual QString LC::Azoth::ICLEntry::GetHumanReadableID ( ) const

inlinevirtual

Returns the human-readable ID of this entry.

This function is used to obtain the human-readable identifier of this entry (for example, Jabber ID in case of XMPP), which may be not so unique as GetEntryID(). For example, if an entry exists in the roster, but it has also requested auth, there would be two entries with the same human-readable ID, but they would still be distinguished by the result of the GetEntryID() function.

Various operations like buddy searches (in protocols that support this feature like Skype or ICQ) are expected to operate on strings that are among possible return values of this function. Also, when initiating entry addition, the entry is expected to be identified by a similar string.

The default implementation returns GetEntryID() as an unicode string.

Returns: Human-readable persistent ID of this entry.

See also: GetEntryID()

Definition at line 248 of file iclentry.h.

References GetEntryID().

Here is the call graph for this function:

◆ GetParentAccount()

virtual IAccount * LC::Azoth::ICLEntry::GetParentAccount ( ) const

pure virtual

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

Returns: The parent account of this entry.

◆ GetParentCLEntry()

virtual ICLEntry * LC::Azoth::ICLEntry::GetParentCLEntry ( ) const

inlinevirtual

Returns the pointer to the parent CL entry, if any.

This currently only makes sense for private chat entries, thus private chat entries (those that are of type ETPrivateChat) should return their parent room CL entry (of type ETMUC).

If parent CL entry is not applicable, NULL should be returned.

The default implementation returns NULL.

Returns: Parent CL entry if applicable, NULL otherwise.

Definition at line 162 of file iclentry.h.

Referenced by GetParentCLEntryObject().

Here is the caller graph for this function:

◆ GetParentCLEntryObject()

QObject * LC::Azoth::ICLEntry::GetParentCLEntryObject ( ) const

inline

Definition at line 167 of file iclentry.h.

References GetParentCLEntry().

Here is the call graph for this function:

◆ GetQObject()

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

pure virtual

Returns the entry as a QObject.

Returns: Contact list entry as QObject.

◆ GetStatus()

virtual EntryStatus LC::Azoth::ICLEntry::GetStatus ( const QString & variant = QString() ) const

pure virtual

Returns the current status of a variant of the item.

Since different variants may have different status, this function should return the proper status for the given variant. If no such variant exists, an empty status structure should be returned.

Parameters

[in] variant The variant to return status for or null string for most important variant.

Returns: The current status.

◆ Groups()

virtual QStringList LC::Azoth::ICLEntry::Groups ( ) const

pure virtual

Returns the list of human-readable names of the groups that this entry belongs to.

Returns: The list of groups of this item.

◆ MarkMsgsRead()

virtual void LC::Azoth::ICLEntry::MarkMsgsRead ( )

pure virtual

Called whenever new messages are read.

This function is called by Azoth Core whenever any unread messages that could be present in this entry are read. For example, this may happen when user opens the chat tab with this entry.

Please note that this function is always called, even when there are no messages at all, for example.

◆ PurgeMessages()

virtual void LC::Azoth::ICLEntry::PurgeMessages ( const QDateTime & before )

pure virtual

Purges messages before the given date.

This function should purge all the messages before the given date. After the call, the corresponding messages should not appear in the result of GetAllMessages() function. It's also suggested to remove them from any internal memory storage to conserve memory.

If before is an invalid date, this function should purge all messages.

Parameters

[in] before The date before which messages should be purged.

◆ SendMessage()

virtual void LC::Azoth::ICLEntry::SendMessage ( const OutgoingMessage & message )

pure virtual

Sends the message described by message.

◆ SetChatPartState()

virtual void LC::Azoth::ICLEntry::SetChatPartState	(	ChatPartState	state,
		const QString &	variant )

pure virtual

Notifies about our chat participation state change.

If variant is a null string, a variant with the highest priority should be used.

Parameters

[in]	state	Our new chat participation state.
[in]	variant	Target variant.

◆ SetEntryName()

virtual void LC::Azoth::ICLEntry::SetEntryName ( const QString & name )

pure virtual

Sets the human-readable name of this entry.

The name is expected to be updated on the server immediately.

Parameters

[in] name The new human-readable name of this entry.

See also: GetEntryName()

◆ SetGroups()

virtual void LC::Azoth::ICLEntry::SetGroups ( const QStringList & groups )

pure virtual

Sets the list of groups this item belongs to.

If updating the list of groups is not applicable, this function should do nothing.

Parameters

[in] groups The new list of groups.

◆ ShowInfo()

virtual void LC::Azoth::ICLEntry::ShowInfo ( )

pure virtual

Requests the entry to show dialog with info about it.

◆ Variants()

virtual QStringList LC::Azoth::ICLEntry::Variants ( ) const

pure virtual

Returns the list of destination variants.

For example, for an entry representing a contact in XMPP protocol variants would be the list of resources for the contact.

Strings in the list should not be null, though they may be empty. There should be no duplicates in returned list.

The strings in the returned list should be sorted in descending order according to importance. For example, for XMPP protocol, the first variant should be the resource with the highest priority.

Returns: The list of variants of this entry.

Member Data Documentation

◆ Emitter_

Emitters::CLEntry LC::Azoth::ICLEntry::Emitter_

protected

Definition at line 59 of file iclentry.h.

Referenced by GetCLEntryEmitter().

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/iclentry.h

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ EntryType

◆ Feature

Constructor & Destructor Documentation

◆ ~ICLEntry()

Member Function Documentation

◆ ChatTabClosed()

◆ GetActions()

◆ GetAllMessages()

◆ GetCLEntryEmitter()

◆ GetClientInfo()

◆ GetEntryFeatures()

◆ GetEntryID()

◆ GetEntryName()

◆ GetEntryType()

◆ GetHumanReadableID()

◆ GetParentAccount()

◆ GetParentCLEntry()

◆ GetParentCLEntryObject()

◆ GetQObject()

◆ GetStatus()

◆ Groups()

◆ MarkMsgsRead()

◆ PurgeMessages()

◆ SendMessage()

◆ SetChatPartState()

◆ SetEntryName()

◆ SetGroups()

◆ ShowInfo()

◆ Variants()

Member Data Documentation

◆ Emitter_