kscoredialog.h

Go to the documentation of this file.

/****************************************************************
Copyright (c) 1998 Sandro Sigala <ssigala@globalnet.it>
Copyright (c) 2001 Waldo Bastian <bastian@kde.org>
Copyright (c) 2007 Matt Williams <matt@milliams.com>
All rights reserved.

Permission to use, copy, modify, and distribute this software
and its documentation for any purpose and without fee is hereby
granted, provided that the above copyright notice appear in all
copies and that both that the copyright notice and this
permission notice and warranty disclaimer appear in supporting
documentation, and that the name of the author not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.

The author disclaim all warranties with regard to this
software, including all implied warranties of merchantability
and fitness.  In no event shall the author be liable for any
special, indirect or consequential damages or any damages
whatsoever resulting from loss of use, data or profits, whether
in an action of contract, negligence or other tortious action,
arising out of or in connection with the use or performance of
this software.
****************************************************************/

#ifndef KSCOREDIALOG_H
#define KSCOREDIALOG_H

#include <libkdegames_export.h>

#include <QtCore/QMap>
#include <QtCore/QFlags>

#include <kdialog.h>

class KLocalizedString;
class KgDifficulty;

class KDEGAMES_EXPORT KScoreDialog : public KDialog
{
    Q_OBJECT

    public:
        enum Fields {
            Name = 1 << 0,
            Level = 1 << 1,
            Date = 1 << 2,
            Time = 1 << 3,
            Score = 1 << 4,

            Custom1 = 1 << 10, 
            Custom2 = 1 << 11,
            Custom3 = 1 << 12,
            Custom4 = 1 << 13,
            Custom5 = 1 << 14,

            Max = 1 << 30 
        };

        enum AddScoreFlag
        {
            AskName = 0x1, 
            LessIsMore = 0x2 
        };
        Q_DECLARE_FLAGS(AddScoreFlags, AddScoreFlag)

        typedef QMap<int, QString> FieldInfo;

        explicit KScoreDialog(int fields=Name, QWidget *parent=0);

        ~KScoreDialog();

        void KDE_DEPRECATED setConfigGroup(const QString& group = QString());
        //void setConfigGroup(const QString& group, const QString& i18nName);

        void setConfigGroup(const QPair<QByteArray, QString>& group);

        void addLocalizedConfigGroupName(const QPair<QByteArray, QString>& group);

        void addLocalizedConfigGroupNames(const QMap<QByteArray, QString>& groups);

        void setHiddenConfigGroups(const QList<QByteArray>& hiddenGroups);

        void setConfigGroupWeights(const QMap<int, QByteArray>& weights);

        void setComment(const QString& comment);

        void addField(int field, const QString& header, const QString& key);

        void hideField(int field);

        int addScore(const FieldInfo& newInfo = FieldInfo(), const AddScoreFlags& flags=0);

        int addScore(int newScore, const AddScoreFlags& flags=0);

        int highScore();

        void initFromDifficulty(const KgDifficulty* difficulty, bool setConfigGroup = true);

        virtual void show();
        virtual void exec();

        private Q_SLOTS:
            void slotGotReturn();
            void slotGotName();
            void slotForgetScore();

        private:
            void keyPressEvent(QKeyEvent *ev);

        private:
            class KScoreDialogPrivate;
            KScoreDialogPrivate* const d;
};
Q_DECLARE_OPERATORS_FOR_FLAGS(KScoreDialog::AddScoreFlags)

#endif //KSCOREDIALOG_H