kexthighscore.h

/*
    This file is part of the TDE games library
    Copyright (C) 2001-2004 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_H
#define KEXTHIGHSCORE_H
 
#include "kexthighscore_item.h"
 
#include <kurl.h>
#include <tdemacros.h>
 
class TQTabWidget;
 
 
namespace KExtHighscore
{
 
class Score;
class Item;
 
class ManagerPrivate;
extern ManagerPrivate *internal;

TDE_EXPORT uint gameType();

TDE_EXPORT void setGameType(uint gameType);

TDE_EXPORT bool configure(TQWidget *parent);

TDE_EXPORT void show(TQWidget *parent);

TDE_EXPORT void submitScore(const Score &score, TQWidget *widget);

TDE_EXPORT Score lastScore();

TDE_EXPORT Score firstScore();

class TDE_EXPORT Manager
{
 public:
    Manager(uint nbGameTypes = 1, uint maxNbEntries = 10);
    virtual ~Manager();
    
    void setWWHighscores(const KURL &url, const TQString &version);

    void setTrackLostGames(bool track);
    
    void setTrackDrawGames(bool track);

    void setShowStatistics(bool show);
    
    // KDE4 remove this
    void showStatistics(bool show) TDE_DEPRECATED;
    
    void setShowDrawGamesStatistic(bool show);
 
    enum ScoreTypeBound { ScoreNotBound, ScoreBound };
    void setScoreHistogram(const TQMemArray<uint> &scores, ScoreTypeBound type);

    enum ShowMode { AlwaysShow,          
                    NeverShow,           
                    ShowForHigherScore,  
                    ShowForHighestScore  
                  };
    void setShowMode(ShowMode mode);

    enum ScoreType { Normal, MinuteTime };
    void setScoreType(ScoreType type);

    enum ItemType { ScoreDefault, MeanScoreDefault, BestScoreDefault,
                    ElapsedTime };

    static Item *createItem(ItemType type);

    void setScoreItem(uint worstScore, Item *item);

    void addScoreItem(const TQString &name, Item *item);
 
    enum PlayerItemType { MeanScore, BestScore };
    void setPlayerItem(PlayerItemType type, Item *item);

    virtual bool isStrictlyLess(const Score &s1, const Score &s2) const;

    enum LabelType { Standard, I18N, WW, Icon };

    virtual TQString gameTypeLabel(uint gameType, LabelType type) const;
 
 protected:
    virtual void convertLegacy(uint gameType) { Q_UNUSED(gameType); }

    void submitLegacyScore(const Score &score) const;

    virtual void additionalQueryItems(KURL &url, const Score &score) const
        { Q_UNUSED(url); Q_UNUSED(score); }

    static void addToQueryURL(KURL &url, const TQString &item,
                              const TQString &content);
 
    friend class ManagerPrivate;
 
 private:
    Manager(const Manager &);
    Manager &operator =(const Manager &);
};
 
} // namespace
 
#endif