File indexing completed on 2024-09-29 12:03:24
0001 /* 0002 This file is part of the KContacts framework. 0003 SPDX-FileCopyrightText: 2016-2019 Laurent Montel <montel@kde.org> 0004 0005 SPDX-License-Identifier: LGPL-2.0-or-later 0006 */ 0007 0008 #ifndef TITLE_H 0009 #define TITLE_H 0010 0011 #include "kcontacts_export.h" 0012 0013 #include <QMap> 0014 #include <QSharedDataPointer> 0015 #include <QString> 0016 0017 class TitleTest; 0018 0019 namespace KContacts 0020 { 0021 class ParameterMap; 0022 0023 /** @short Class that holds a Title for a contact. 0024 * @since 5.3 0025 */ 0026 class KCONTACTS_EXPORT Title 0027 { 0028 friend KCONTACTS_EXPORT QDataStream &operator<<(QDataStream &, const Title &); 0029 friend KCONTACTS_EXPORT QDataStream &operator>>(QDataStream &, Title &); 0030 friend class VCardTool; 0031 friend class ::TitleTest; 0032 0033 public: 0034 Title(); 0035 Title(const Title &other); 0036 Title(const QString &title); 0037 0038 ~Title(); 0039 0040 typedef QVector<Title> List; 0041 0042 void setTitle(const QString &title); 0043 Q_REQUIRED_RESULT QString title() const; 0044 0045 Q_REQUIRED_RESULT bool isValid() const; 0046 0047 #if KCONTACTS_ENABLE_DEPRECATED_SINCE(5, 88) 0048 /** 0049 * @deprecated Since 5.88 for lack of usage 0050 */ 0051 KCONTACTS_DEPRECATED_VERSION(5, 88, "For lack of usage.") 0052 void setParameters(const QMap<QString, QStringList> ¶ms); 0053 #endif 0054 0055 #if KCONTACTS_ENABLE_DEPRECATED_SINCE(5, 88) 0056 /** 0057 * @deprecated Since 5.88 for lack of usage 0058 */ 0059 Q_REQUIRED_RESULT 0060 KCONTACTS_DEPRECATED_VERSION(5, 88, "For lack of usage.") 0061 QMap<QString, QStringList> parameters() const; 0062 #endif 0063 0064 Q_REQUIRED_RESULT bool operator==(const Title &other) const; 0065 Q_REQUIRED_RESULT bool operator!=(const Title &other) const; 0066 0067 Title &operator=(const Title &other); 0068 0069 Q_REQUIRED_RESULT QString toString() const; 0070 0071 private: 0072 // exported for TitleTest 0073 void setParams(const ParameterMap ¶ms); 0074 Q_REQUIRED_RESULT ParameterMap params() const; 0075 0076 class Private; 0077 QSharedDataPointer<Private> d; 0078 }; 0079 KCONTACTS_EXPORT QDataStream &operator<<(QDataStream &stream, const Title &object); 0080 0081 KCONTACTS_EXPORT QDataStream &operator>>(QDataStream &stream, Title &object); 0082 } 0083 Q_DECLARE_TYPEINFO(KContacts::Title, Q_MOVABLE_TYPE); 0084 #endif // TITLE_H