/usr/include/kopete/kopeteglobal.h is in libkopete-dev 4:17.08.3-0ubuntu3.
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 | /*
kopeteglobal.h - Kopete Globals
Copyright (c) 2004 by Richard Smith <kde@metafoo.co.uk>
Kopete (c) 2004 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 KOPETEGLOBAL_H
#define KOPETEGLOBAL_H
#include "kopeteproperty.h"
#include "kopete_export.h"
/**
* This namespace contains all of Kopete's core classes and functions.
*/
namespace Kopete
{
/**
* This namespace contains Kopete's global settings and functions
*/
namespace Global
{
class PropertiesPrivate;
/**
* \brief Global facility to query/store templates that are needed by KopeteProperty
*
* Basically all a plugin author needs to worry about is creating PropertyTmpl
* objects for all the properties he wants to set for a Kopete::Contact,
* everything else is handled behind the scenes.
**/
class KOPETE_EXPORT Properties
{
friend class Kopete::PropertyTmpl;
public:
/**
* \brief Singleton accessor for this class.
*
* Use it to access the global list of property-templates or to get
* a reference to one of the common PropertyTmpl objects
*/
static Properties *self();
/**
* Return a template with defined by @p key, if no such template has
* been registered PropertyTmpl::null will be returned
*/
const PropertyTmpl &tmpl(const QString &key) const;
/**
* @return a ready-to-use template for a contact's full name.
*
* This is actually no real property, it makes use of
* firstName() and lastName() to assemble an name that consists of
* both name parts
*/
const PropertyTmpl &fullName() const;
/**
* Return default template for a contact's idle-time
*/
const PropertyTmpl &idleTime() const;
/**
* Return default template for a contact's online-since time
* (i.e. time since he went from offline to online)
*/
const PropertyTmpl &onlineSince() const;
/**
* @return default template for a contact's last-seen time
*/
const PropertyTmpl &lastSeen() const;
/**
* @return default template for a contact's status title
*/
const PropertyTmpl &statusTitle() const;
/**
* @return default template for a contact's status message
*/
const PropertyTmpl &statusMessage() const;
/**
* @return default template for a contact's first name
*/
const PropertyTmpl &firstName() const;
/**
* @return default template for a contact's last name
*/
const PropertyTmpl &lastName() const;
/**
* @return default template for a contact's email-address
*/
const PropertyTmpl &emailAddress() const;
/**
* @return default template for a contact's private phone number
*/
const PropertyTmpl &privatePhone() const;
/**
* @return default template for a contact's private mobile number
*/
const PropertyTmpl &privateMobilePhone() const;
/**
* @return default template for a contact's work phone number
*/
const PropertyTmpl &workPhone() const;
/**
* @return default template for a contact's work mobile number
*/
const PropertyTmpl &workMobilePhone() const;
/**
* @return default template for a contact's nickname (set by the contact)
* This property comes from contact and cannot be changed by user custom name
*/
const PropertyTmpl &nickName() const;
/**
* @return default template for a contact's nickname (set by the contact)
* This property is set by user and stored on server contact list
*/
const PropertyTmpl &customName() const;
/**
* @return default template for a contact's visibility even if offline
*/
const PropertyTmpl &isAlwaysVisible() const;
/**
* default template for a contact's photo.
*
* It could be either a QString or a QImage.
* If it's a QString, it should points to the path the image is stored.
*/
const PropertyTmpl &photo() const;
/**
* @return a map of all registered PropertyTmpl object
*/
const PropertyTmpl::Map &templateMap() const;
/**
* return true if a template with key @p key is already registered,
* false otherwise
*/
bool isRegistered(const QString &key);
private:
Properties();
~Properties();
bool registerTemplate(const QString &key,
const PropertyTmpl &tmpl);
void unregisterTemplate(const QString &key);
const PropertyTmpl &createProp(const QString &key,
const QString &label, const QString &icon=QString(),
bool persistent = false) const;
private:
static Properties *mSelf;
PropertiesPrivate *d;
}; // end class Properties
} // Global
} // Kopete
#endif
// vim: set noet ts=4 sts=4 sw=4:
|