kexthighscore_item.h

/*
    This file is part of the TDE games library
    Copyright (C) 2001-2003 Nicolas Hadacek (hadacek@kde.org)
 
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License version 2 as published by the Free Software Foundation.
 
    This library 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
    Library General Public License for more details.
 
    You should have received a copy of the GNU Library General Public License
    along with this library; see the file COPYING.LIB.  If not, write to
    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
    Boston, MA 02110-1301, USA.
*/
 
#ifndef KEXTHIGHSCORE_ITEM_H
#define KEXTHIGHSCORE_ITEM_H
 
#include <tqvariant.h>
#include <tqnamespace.h>
#include <tqmap.h>
#include <tqvaluevector.h>
#include <tdemacros.h>
class TQWidget;
 
 
namespace KExtHighscore
{
 
//-----------------------------------------------------------------------------
class TDE_EXPORT Item
{
 public:
    enum Format { NoFormat, OneDecimal, Percentage, MinuteTime,
                  DateTime };

    enum Special { NoSpecial, ZeroNotDefined, NegativeNotDefined,
                   DefaultNotDefined, Anonymous };

    Item(const TQVariant &def = TQVariant::Invalid,
         const TQString &label = TQString(), int alignment = TQt::AlignRight);
 
    virtual ~Item();

    void setPrettyFormat(Format format);

    void setPrettySpecial(Special special);

    bool isVisible() const    { return !_label.isEmpty(); }

    void setLabel(const TQString &label) { _label = label; }

    TQString label() const { return _label; }

    int alignment() const { return _alignment; }

    void setDefaultValue(const TQVariant &value) { _default = value; }

    const TQVariant &defaultValue() const { return _default; }

    virtual TQVariant read(uint i, const TQVariant &value) const;

    virtual TQString pretty(uint i, const TQVariant &value) const;
 
 private:
    TQVariant _default;
    TQString  _label;
    int      _alignment;
    Format   _format;
    Special  _special;
 
    class ItemPrivate;
    ItemPrivate *d;
 
    static TQString timeFormat(uint);
};
 
//-----------------------------------------------------------------------------
enum ScoreType { Won = 0, Lost = -1, Draw = -2 };

class TDE_EXPORT Score
{
 public:
    Score(ScoreType type = Won);
 
    ~Score();

    ScoreType type() const { return _type; }

    void setType(ScoreType type) { _type = type; }

    const TQVariant &data(const TQString &name) const;

    void setData(const TQString &name, const TQVariant &value);

    uint score() const { return data("score").toUInt(); }

    void setScore(uint score) { setData("score", score); }

    bool isTheWorst() const;

    bool operator <(const Score &score);
 
 private:
    ScoreType  _type;
    TQStringVariantMap _data;
 
    class ScorePrivate;
    ScorePrivate *d;
 
    friend class MultiplayerScores;
 
    friend TQDataStream &operator <<(TQDataStream &stream, const Score &score);
    friend TQDataStream &operator >>(TQDataStream &stream, Score &score);
};
 
TDE_EXPORT TQDataStream &operator <<(TQDataStream &stream, const Score &score);
TDE_EXPORT TQDataStream &operator >>(TQDataStream &stream, Score &score);

class TDE_EXPORT MultiplayerScores
{
 public:
    MultiplayerScores();
 
    ~MultiplayerScores();

    void setPlayerCount(uint nb);

    void setName(uint player, const TQString &name);

    void addScore(uint player, const Score &score);

    void clear();

    void show(TQWidget *parent);
 
 private:
    TQValueVector<uint>  _nbGames;
    TQValueVector<Score> _scores;
 
    class MultiplayerScoresPrivate;
    MultiplayerScoresPrivate *d;
 
    friend TQDataStream &operator <<(TQDataStream &stream,
                                    const MultiplayerScores &score);
    friend TQDataStream &operator >>(TQDataStream &stream,
                                    MultiplayerScores &score);
};
 
TDE_EXPORT TQDataStream &operator <<(TQDataStream &stream, const MultiplayerScores &score);
TDE_EXPORT TQDataStream &operator >>(TQDataStream &stream, MultiplayerScores &score);
 
} // namespace
 
#endif