/usr/include/kopete/kopeteidentity.h is in libkopete-dev 4:15.12.3-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 | /*
kopeteidentity.h - Kopete Identity
Copyright (c) 2007 by Gustavo Pichorim Boiko <gustavo.boiko@kdemail.net>
(c) 2007 Will Stephenson <wstephenson@kde.org>
Kopete (c) 2002-2007 by the Kopete developers <kopete-devel@kde.org>
*************************************************************************
* *
* 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 of the License, or (at your option) any later version. *
* *
*************************************************************************
*/
#ifndef KOPETEIDENTITY_H
#define KOPETEIDENTITY_H
#include <kdemacros.h>
#include "kopeteglobal.h"
#include "kopetepropertycontainer.h"
#include "kopeteonlinestatus.h"
#include "kopete_export.h"
class KConfigGroup;
namespace Kopete
{
class Account;
class StatusMessage;
/**
* @author Gustavo Pichorim Boiko <gustavo.boiko@kdemail.net>
*
* An identity that might contain one or more accounts associated to it
*/
class KOPETE_EXPORT Identity : public PropertyContainer
{
Q_OBJECT
public:
typedef QList<Identity*> List;
/**
* @brief The main constructor for Kopete Identities
*
* This will create an empty identity with a random id
* @param label the label to use for this identity
*/
Identity(const QString &label);
/**
* @brief Constructor for deserialising stored Identities
* @param id the stored Identity's id
* @param label the stored Identity's label
*/
Identity(const QString &id, const QString &label);
~Identity();
/**
* @brief Duplicates an existing identity
*
* This will create a new identity name @param id, that clones all properties
* @return duplicate Identity
*/
Identity * clone() const;
/**
* The id is a unique internal handle and should not be exposed in the UI
* @return the identity's id
*/
QString id() const;
/**
* The label is used to identify the identity in the UI
* @return the identity's label
*/
QString label() const;
/**
* Sets the label
* @param newLabel a new label for the identity
*/
void setLabel( const QString & label );
/**
* This identity should be connected when connect all is called?
*/
bool excludeConnect() const;
/**
* @brief Get the online status of the identity
* @return the online status of the identity
*/
OnlineStatus::StatusType onlineStatus() const;
/**
* @brief Get the current status message of the identity
*/
Kopete::StatusMessage statusMessage() const;
/**
* \brief Get the tooltip for this identity
* \return an RTF tooltip depending on Kopete::AppearanceSettings settings
**/
QString toolTip() const;
/**
* \brief Return the icon for this identity
*/
QString customIcon() const;
/**
* Returns the accounts assigned to this identity
*/
QList<Account*> accounts() const;
/**
* @brief Adds an account to the identity
*
* @param account the account to be added
*/
void addAccount( Kopete::Account *account );
/**
* Returns the @ref KConfigGroup that should be used to read/write settings
* of this identity
*/
KConfigGroup *configGroup() const;
/**
* Load the identity information
*/
void load();
/**
* Save the identity information
*/
void save();
public slots:
/**
* @brief Sets the online status for this identity
* Sets the online status for each account in this identity, except those which are set to
* 'Exclude from connect all' (Kopete::Account::excludeConnect()).
* @param category generic OnlineStatusManager::Categories identifying status to set
* @param statusMessage is the new status message to use in this onlinestatus
*/
void setOnlineStatus( uint category, const Kopete::StatusMessage &statusMessage );
/**
* @brief Sets the status message for this identity
* Sets the status message for each account in this identity, except those which are set to
* 'Exclude from connect all' (Kopete::Account::excludeConnect()).
* @param statusMessage is the new status message to use
*/
void setStatusMessage( const Kopete::StatusMessage &statusMessage );
/**
* @brief Removes an account from the identity
*
* @param account the account to be removed
*/
void removeAccount( const Kopete::Account *account );
void updateOnlineStatus();
protected slots:
void slotSaveProperty( Kopete::PropertyContainer *container, const QString &key,
const QVariant &oldValue, const QVariant &newValue );
signals:
void onlineStatusChanged( Kopete::Identity* );
void toolTipChanged( Kopete::Identity* );
void identityDestroyed( const Kopete::Identity *identity );
void identityChanged(Kopete::Identity *identity);
private:
class Private;
Private * const d;
};
} //END namespace Kopete
#endif
|