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