kdeconnect-kde/smsapp/conversationmodel.h
Jiří Wolker 365791dc59 Show remaining character count in SMS app
## Summary

This adds character counter below the “Send” button in SMS conversation. It
uses format XXX/Y where XXX is number of characters that can be added
without splitting the SMS into multiple messages (see article
Concatenated SMS on Wikipedia). Y is number of messages in in current
concatenated SMS. The counter is not visible when insertion of 10 7-bit
or 16-bit (depends on SMS encoding) does not create concatenated SMS.

SMS encoding is automatically guessed. 8-bit encodings are not
supported. If the message contains characters that are not supported by GSM 7-bit
encoding, counter automatically switches to UCS-2.

## Test Plan

Try entering some text that is longer than 150 characters in [GSM 03.38 encoding][1] or 60 characters in UCS-2. Number of remaining characters should be visible below the “Send” button. The character counter should show `0` at exactly 160 or 70 characters. Inserting one character should switch the counter to [Concatenated SMS][2] mode when number of messages is shown.

It should show exactly same number as SMS app in Android.

## Screenshots

These images are in APNG.

![grab.apng](/uploads/21ae23f2fa75c7aca487e61ddce94644/grab.apng)
![grab-cz.apng](/uploads/785e670a8598c5a65a4209f17e75f578/grab-cz.apng)

[1]: https://en.wikipedia.org/w/index.php?oldid=932080074#GSM_7-bit_default_alphabet_and_extension_table_of_3GPP_TS_23.038_/_GSM_03.38
[2]: https://en.wikipedia.org/w/index.php?oldid=943185255#Message_size
2020-03-22 18:47:12 +00:00

102 lines
3.7 KiB
C++

/**
* Copyright (C) 2018 Aleix Pol Gonzalez <aleixpol@kde.org>
* Copyright (C) 2018 Simon Redman <simon@ergotech.com>
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of
* the License or (at your option) version 3 or any later version
* accepted by the membership of KDE e.V. (or its successor approved
* by the membership of KDE e.V.), which shall act as a proxy
* defined in Section 14 of version 3 of the license.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#ifndef CONVERSATIONMODEL_H
#define CONVERSATIONMODEL_H
#include <QStandardItemModel>
#include <QLoggingCategory>
#include <QSet>
#include "interfaces/conversationmessage.h"
#include "interfaces/dbusinterfaces.h"
Q_DECLARE_LOGGING_CATEGORY(KDECONNECT_SMS_CONVERSATION_MODEL)
#define INVALID_THREAD_ID -1
class ConversationModel
: public QStandardItemModel
{
Q_OBJECT
Q_PROPERTY(qint64 threadId READ threadId WRITE setThreadId)
Q_PROPERTY(QString deviceId READ deviceId WRITE setDeviceId)
Q_PROPERTY(QString otherParty READ otherPartyAddress WRITE setOtherPartyAddress)
public:
ConversationModel(QObject* parent = nullptr);
~ConversationModel();
enum Roles {
FromMeRole = Qt::UserRole,
SenderRole, // The sender of the message. Undefined if this is an outgoing message
DateRole,
AvatarRole, // URI to the avatar of the sender of the message. Undefined if outgoing.
};
Q_ENUM(Roles)
qint64 threadId() const;
void setThreadId(const qint64& threadId);
QString deviceId() const { return m_deviceId; }
void setDeviceId(const QString &/*deviceId*/);
QString otherPartyAddress() const { return m_otherPartyAddress; }
void setOtherPartyAddress(const QString& address);
Q_INVOKABLE void sendReplyToConversation(const QString& message);
Q_INVOKABLE void sendMessageWithoutConversation(const QString& message, const QString& address);
Q_INVOKABLE void requestMoreMessages(const quint32& howMany = 10);
/**
* Convert a list of names into a single string suitable for display
* TODO: This is here because I don't know how to make the QML call the smshelper directly
* but that is what should be happening!
*/
Q_INVOKABLE QString getTitleForAddresses(const QList<ConversationAddress>& addresses);
/**
* This is the action invoked by the right-click menu to copy to the clipboard
* QML can't do this directly but this should be part of smshelper
* TODO: Move to smshelper (or maybe make part of kirigami-addons chat library?)
*/
Q_INVOKABLE void copyToClipboard(const QString& message) const;
Q_INVOKABLE QString getCharCountInfo(const QString& message) const;
Q_SIGNALS:
void loadingFinished();
private Q_SLOTS:
void handleConversationUpdate(const QDBusVariant &message);
void handleConversationLoaded(qint64 threadID, quint64 numMessages);
void handleConversationCreated(const QDBusVariant &message);
private:
void createRowFromMessage(const ConversationMessage &message, int pos);
DeviceConversationsDbusInterface* m_conversationsInterface;
QString m_deviceId;
qint64 m_threadId = INVALID_THREAD_ID;
QString m_otherPartyAddress;
QSet<qint32> knownMessageIDs; // Set of known Message uIDs
};
#endif // CONVERSATIONMODEL_H