text.h

Go to the documentation of this file.

/***************************************************************************

    Copyright 2008 Avgoustinos Kadis <avgoustinos.kadis@kdemail.net>

 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
#ifndef SCRIPTINGTEXT_H
#define SCRIPTINGTEXT_H

#include <QObject>
#include <keduvoctext.h>

namespace Scripting
{

    class Text : public QObject
    {
            Q_OBJECT

            Q_PROPERTY ( QString text READ text WRITE setText )

            
            Q_PROPERTY ( unsigned int practiceCount READ practiceCount WRITE setPracticeCount )

            Q_PROPERTY ( unsigned int badCount READ badCount WRITE setBadCount )

            Q_PROPERTY ( unsigned int grade READ grade() WRITE setGrade )

            // last date when this word was practiced
//             Q_PROPERTY ( QDateTime practiceDate READ practiceDate WRITE setPracticeDate )

            Q_PROPERTY ( bool isEmpty READ isEmpty )

        public:
            /* default constructor */
            Text ( const QString& text = QString() );

            /* copy constructor
             * provides safe copy of d pointer
             * @param other object to copy from
             */
//             KEduVocText ( const KEduVocText &other );

            /*
             * Constructor from KEduVocText (not used by scripts)
             * @param text KEduVocText to initialize Scripting::Text
             */
            Text ( KEduVocText * text );

            Text ( const KEduVocText & text );

            ~Text();

            KEduVocText * kEduVocText() { return m_text; }

            /*
             * The translation as string (the word itself)
             * @return the translation
             */
            QString text() const { return m_text->text(); }

            /*
             * Sets the translation
             * @param expr
             */
            void setText ( const QString & expr ) { m_text->setText ( expr ); }

            /*
             * Equal operator to copy grades.
             * @param other grades copied
             * @return reference to the new grades
             */
//             Text& operator= ( const Text &other ) { m_text->operator=(*(other.kEduVocText())); }
            /*
             * Compare two sets of grades.
             * @param other
             * @return true if equal
             */
//             bool operator== ( const KEduVocText &other ) const;


            /* returns how often this entry has been practiced as int
            * @returns total count
            */
            unsigned int practiceCount() const { return m_text->practiceCount(); }

            /* set how often this entry has been practiced as int
            * @param count the new count
            */
            void setPracticeCount ( unsigned int count ) { m_text->setPracticeCount ( count ); }

            /* returns bad query count as int
            * @returns bad query count
            */
            unsigned int badCount() const { return m_text->badCount(); }

            /* set bad query count as int
            * @param count the new count
            */
            void setBadCount ( unsigned int count ) { m_text->setBadCount ( count ); }

            /* sets the grade
            * @param grade number of knowlegde: 0=known, x=numbers not knows
            */
            void setGrade ( unsigned int grade ) { m_text->setGrade ( grade ); }

            /* returns grade as int
            * @returns number of knowlegde: 0=known, x=numbers not knows
            */
            unsigned int grade() const { return m_text->grade(); }

            /*
             * If the string inside is empty this returns true.
             * @return
             */
            bool isEmpty() { return m_text->isEmpty(); }

//             void fromKVTML2 ( QDomElement& parent );
//             void toKVTML2 ( QDomElement& parent );

        public slots:
            void incBadCount() { m_text->incBadCount(); }

            void incPracticeCount() { m_text->incPracticeCount(); }

            void resetGrades() { m_text->resetGrades(); }

            void incGrade() { m_text->incGrade(); }

            void decGrade() { m_text->decGrade(); }

            QString practiceDate() const { return m_text->practiceDate().toString(); }

            QString practiceDate ( const QString & format ) const { return m_text->practiceDate().toString ( format ); }

            void setPracticeDate ( const QString & date ) { m_text->setPracticeDate ( QDateTime::fromString ( date ) ); }

            void setPracticeDate ( const QString & date, const QString & format ) { m_text->setPracticeDate ( QDateTime::fromString ( date, format ) ); }

        protected:
            KEduVocText * m_text;

    };

}

#endif