/****************************************************************************** * Copyright (C) 2015 Felix Rohrbach * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ #pragma once #include #include #include "avatar.h" namespace QMatrixClient { class Event; class Connection; class User: public QObject { Q_OBJECT Q_PROPERTY(QString id READ id CONSTANT) Q_PROPERTY(bool isGuest READ isGuest CONSTANT) Q_PROPERTY(QString name READ name NOTIFY nameChanged) Q_PROPERTY(QString displayName READ displayname NOTIFY nameChanged STORED false) Q_PROPERTY(QString fullName READ fullName NOTIFY nameChanged STORED false) Q_PROPERTY(QString bridgeName READ bridged NOTIFY nameChanged STORED false) Q_PROPERTY(QString avatarMediaId READ avatarMediaId NOTIFY avatarChanged STORED false) Q_PROPERTY(QUrl avatarUrl READ avatarUrl NOTIFY avatarChanged) public: User(QString userId, Connection* connection); ~User() override; /** Get unique stable user id * User id is generated by the server and is not changed ever. */ QString id() const; /** Get the name chosen by the user * This may be empty if the user didn't choose the name or cleared * it. * \sa displayName */ QString name() const; /** Get the displayed user name * This method returns the result of name() if its non-empty; * otherwise it returns user id. This is convenient to show a user * name outside of a room context. In a room context, user names * should be disambiguated. * \sa name, id, fullName Room::roomMembername */ QString displayname() const; /** Get user name and id in one string * The constructed string follows the format 'name (id)' * used for users disambiguation in a room context and in other * places. * \sa displayName, Room::roomMembername */ QString fullName() const; /** * Returns the name of bridge the user is connected from or empty. */ QString bridged() const; /** Whether the user is a guest * As of now, the function relies on the convention used in Synapse * that guests and only guests have all-numeric IDs. This may or * may not work with non-Synapse servers. */ bool isGuest() const; const Avatar& avatarObject() const; Q_INVOKABLE QImage avatar(int dimension); Q_INVOKABLE QImage avatar(int width, int height); QImage avatar(int width, int height, Avatar::get_callback_t callback); QString avatarMediaId() const; QUrl avatarUrl() const; void processEvent(Event* event); public slots: void rename(const QString& newName); bool setAvatar(const QString& fileName); bool setAvatar(QIODevice* source); signals: void nameChanged(QString newName, QString oldName); void avatarChanged(User* user); private slots: void updateName(const QString& newName); void updateAvatarUrl(const QUrl& newUrl); private: class Private; Private* d; }; } Q_DECLARE_METATYPE(QMatrixClient::User*)