Proxy class providing a 1:1 mapping of the D-Bus interface "org.freedesktop.Telepathy.Channel.Interface.Subject2".
Tp::PendingVariant* Tp::Client::ChannelInterfaceSubjectInterface::requestPropertySubject |
( |
| ) |
const |
|
inline |
Asynchronous getter for the remote object property Subject
of type QString
.
The human-readable subject on the channel such as the topic
in an IRC channel, or the room name in XMPP MUCs.
This property replaces the subject Telepathy
property of Text channels, as Telepathy properties are soon to
be deprecated completely.
This property may change during the lifetime of the channel and
MUST not be included in a channel request.
- Returns
- A pending variant which will emit finished when the property has been retrieved.
Tp::PendingVariant* Tp::Client::ChannelInterfaceSubjectInterface::requestPropertyActor |
( |
| ) |
const |
|
inline |
Asynchronous getter for the remote object property Actor
of type QString
.
The normalized contact ID representing who last modified
the subject, or the empty string if it is not known.
This property replaces the subject-contact
Telepathy property of Text channels, as Telepathy properties
are soon to be deprecated completely.
- Returns
- A pending variant which will emit finished when the property has been retrieved.
Tp::PendingVariant* Tp::Client::ChannelInterfaceSubjectInterface::requestPropertyTimestamp |
( |
| ) |
const |
|
inline |
Asynchronous getter for the remote object property Timestamp
of type qlonglong
.
A unix timestamp indicating when the subject was last
modified, or INT_MAX64
if unknown.
This property replaces the subject-timestamp
Telepathy property of Text channels, as Telepathy properties
are soon to be deprecated completely.
- Returns
- A pending variant which will emit finished when the property has been retrieved.
Tp::PendingVariant* Tp::Client::ChannelInterfaceSubjectInterface::requestPropertyCanSet |
( |
| ) |
const |
|
inline |
Asynchronous getter for the remote object property CanSet
of type bool
.
TRUE if the Subject property
can be set by the user by calling
SetSubject() , otherwise
FALSE.
If implementations are unsure of what this value should be
it SHOULD still be set to what it believes the value
is. As a result, clients should be aware that
SetSubject() can still fail
even with this property set to TRUE.
In XMPP it is impossible to know whether an
occupant can set the subject as XMPP server implementations
are wildly inconsistent.
- Returns
- A pending variant which will emit finished when the property has been retrieved.
QDBusPendingReply Tp::Client::ChannelInterfaceSubjectInterface::SetSubject |
( |
const QString & |
subject, |
|
|
int |
timeout = -1 |
|
) |
| |
|
inlineslot |
Begins a call to the D-Bus method SetSubject
on the remote object.
Set the room's subject. Clients SHOULD look at the subject
flags before calling this method as the user might not have
permission to set the subject.
A successful return of this method indicates a successful
change in subject, but clients should still listen for changes
to the Subject property for
further changes by other users or the server.
Note that timeout is ignored as of now. It will be used once http://bugreports.qt.nokia.com/browse/QTBUG-11775 is fixed.
- Parameters
-
subject | The new subject.
|
timeout | The timeout in milliseconds. |