Home · All Classes · All Namespaces · Modules · Functions · Files
Classes | Public Member Functions
Tp::ReceivedMessage Class Reference

The ReceivedMessage class is a subclass of Message, representing a received message. More...

#include <TelepathyQt4/TextChannel>

Inherits Tp::Message.

List of all members.

Classes

Public Member Functions


Detailed Description

The ReceivedMessage class is a subclass of Message, representing a received message.

It contains additional information that's generally only available on received messages.


Constructor & Destructor Documentation

Tp::ReceivedMessage::ReceivedMessage ( const ReceivedMessage other)

Copy constructor.

Tp::ReceivedMessage::~ReceivedMessage ( )

Destructor.


Member Function Documentation

ReceivedMessage & Tp::ReceivedMessage::operator= ( const ReceivedMessage other)

Assignment operator.

QDateTime Tp::ReceivedMessage::received ( ) const

Return the time the message was received.

Returns:
A timestamp
ContactPtr Tp::ReceivedMessage::sender ( ) const

Return the Contact who sent the message, or ContactPtr(0) if unknown.

Returns:
The sender or ContactPtr(0)
QString Tp::ReceivedMessage::senderNickname ( ) const

Return the nickname chosen by the sender of the message, which can be different for each message in a conversation.

Returns:
The nickname chosen by the sender of the message.
QString Tp::ReceivedMessage::supersededToken ( ) const

If this message replaces a previous message, return the value of messageToken() for that previous message. Otherwise, return an empty string.

For instance, a user interface could replace the superseded message with this message, or grey out the superseded message.

Returns:
The token of the superseded message or an empty string if none.
bool Tp::ReceivedMessage::isScrollback ( ) const

Return whether the incoming message was part of a replay of message history.

If true, loggers can use this to improve their heuristics for elimination of duplicate messages (a simple, correct implementation would be to avoid logging any message that has this flag).

Returns:
whether the scrollback flag is set
bool Tp::ReceivedMessage::isRescued ( ) const

Return whether the incoming message was seen in a previous channel during the lifetime of this Connection, but was not acknowledged before that chanenl closed, causing the channel in which it now appears to open.

If true, loggers should not log this message again.

Returns:
whether the rescued flag is set
bool Tp::ReceivedMessage::isDeliveryReport ( ) const

Return whether the incoming message is a delivery report.

Returns:
Whether the message is a delivery report.
ReceivedMessage::DeliveryDetails Tp::ReceivedMessage::deliveryDetails ( ) const

Return the details of a delivery report.

This method should only be used if isDeliveryReport() returns true.

Returns:
The details of a delivery report.
bool Tp::ReceivedMessage::isFromChannel ( const TextChannelPtr &  channel) const


Copyright © 2008-2011 Collabora Ltd. and Nokia Corporation
Telepathy-Qt4 0.7.1