/usr/include/kopete/kopeteonlinestatusmanager.h is in libkopete-dev 4:4.13.0-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 | /*
kopeteonlinestatusmanager.h
Copyright (c) 2004-2005 by Olivier Goffart <ogoffart@kde.org>
Kopete (c) 2004-2005 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 kopeteonlinestatusmanager_h__
#define kopeteonlinestatusmanager_h__
#include "kopete_export.h"
#include <QtCore/QObject>
#include <QtCore/QFlags>
#include <QtCore/QMap>
class QPixmap;
class QColor;
class KIcon;
namespace Kopete
{
class OnlineStatus;
class Protocol;
/**
* OnlineStatusManager is a singleton which manage OnlineStatus
*
* @author Olivier Goffart
*/
class KOPETE_EXPORT OnlineStatusManager : public QObject
{
Q_OBJECT
public:
static OnlineStatusManager* self();
~OnlineStatusManager();
/**
* Kopete will uses categories to have a more general system than simply globally away.
*
* Idealy, in each protocol, there should be one status per categories (status may be in several or in none categories
*
* Idle is the status used for auto-away
*
* Status number are organised so that make a tree.
*/
//please be carrefull when modifying values of status. read comment in onlineStatus()
enum Category
{
Idle=1<<8, ExtendedAway=1<<9 , Invisible=1<<10,
// \ / __________/
/*1<<4*/ Busy=1<<5, FreeForChat=1<<6, /* 1<<7*/
// \ / /
Away=1<<2, /* 1<<3 */
// \ /
Online=1<<1,
Offline=1
};
Q_DECLARE_FLAGS(Categories, Category)
/**
* @see registerOnlineStatus
*/
enum Option
{
/// The user may set status messages for this online status
HasStatusMessage = 0x01,
/// The action of the status will be disabled if the account is offline.
/// use it if your protocol doesn't support connecting with the status as initial status.
/// You praticaly shouldn't abuse of that, and automatically set status after connecting if possible
DisabledIfOffline = 0x02,
/// The status will not appears in the action menu. Used if you want to register the status for e.g. autoaway,
/// without letting the user set itself that status
HideFromMenu = 0x04
};
Q_DECLARE_FLAGS(Options, Option)
/**
* You need to register each status an account can be.
* Registered statuses will appear in the account menu.
*
* You should use a special OnlineStatus constructor that call this function automatically
* The Protocol constructor is a good place to construct the OnlineStatuses
*
* You can set the status to be in the predefined categories.
* Ideally, each category should own one status.
* A status may be in several categories, or in none.
* There shouldn't be more than one status per protocol per categories.
*
* @param status The status to register
*/
void registerOnlineStatus(const OnlineStatus& status);
/**
* return the status of the @p protocol which is in the category @p category
*
* If no status has been registered in this category, return the one in the category which is the most similair
*/
OnlineStatus onlineStatus(Protocol *protocol, Categories category) const;
/**
* return the registered statuses for given @p protocol
*/
QList<OnlineStatus> registeredStatusList( Protocol *protocol ) const;
/**
* return KIcon for given @p category
*/
static KIcon pixmapForCategory( Categories category );
/**
* This returns status from config as Kopete::OnlineStatusManager::Category
*
* @return the desired initial status
*/
Kopete::OnlineStatusManager::Category initialStatus() const;
private:
friend class OnlineStatus;
friend class OnlineStatusIconEngine;
QPixmap cacheLookupByObject( const OnlineStatus &statusFor, const QString& icon, int size, QColor color, bool idle = false);
QPixmap cacheLookupByMimeSource( const QString &mimeSource );
QString fingerprint( const OnlineStatus &statusFor, const QString& icon, int size, QColor color, bool idle = false);
QPixmap* renderIcon( const OnlineStatus &statusFor, const QString& baseicon, int size, QColor color, bool idle = false) const;
signals:
void iconsChanged();
private slots:
void slotIconsChanged();
private:
OnlineStatusManager();
class Private;
Private * const d;
};
Q_DECLARE_OPERATORS_FOR_FLAGS(OnlineStatusManager::Categories)
Q_DECLARE_OPERATORS_FOR_FLAGS(OnlineStatusManager::Options)
} //END namespace Kopete
#endif
// vim: set noet ts=4 sts=4 sw=4:
|