form.h

Go to the documentation of this file.

/***************************************************************************
 *   Copyright (C) 2007 by Pino Toscano <pino@kde.org>                     *
 *                                                                         *
 *   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 _OKULAR_FORM_H_
#define _OKULAR_FORM_H_

#include "okular_export.h"
#include "area.h"

#include <QtCore/QStringList>

namespace Okular {

class Action;
class Page;
class PagePrivate;
class FormFieldPrivate;
class FormFieldButtonPrivate;
class FormFieldTextPrivate;
class FormFieldChoicePrivate;

class OKULAR_EXPORT FormField
{
    friend class Page;
    friend class PagePrivate;

    public:
        enum FieldType
        {
            FormButton,      
            FormText,        
            FormChoice,      
            FormSignature    
        };

        virtual ~FormField();

        FieldType type() const;

        virtual NormalizedRect rect() const = 0;

        virtual int id() const = 0;

        virtual QString name() const = 0;

        virtual QString uiName() const = 0;

        virtual bool isReadOnly() const;

        virtual bool isVisible() const;

        Action* activationAction() const;

    protected:
        FormField( FormFieldPrivate &dd );
        Q_DECLARE_PRIVATE( FormField )
        FormFieldPrivate *d_ptr;

        void setActivationAction( Action *action );

    private:
        Q_DISABLE_COPY( FormField )
};


class OKULAR_EXPORT FormFieldButton : public FormField
{
    public:
        enum ButtonType
        {
            Push,          
            CheckBox,      
            Radio          
        };

        virtual ~FormFieldButton();

        virtual ButtonType buttonType() const = 0;

        virtual QString caption() const = 0;

        virtual bool state() const = 0;

        virtual void setState( bool state );

        virtual QList< int > siblings() const = 0;

    protected:
        FormFieldButton();

    private:
        Q_DECLARE_PRIVATE( FormFieldButton )
        Q_DISABLE_COPY( FormFieldButton )
};


class OKULAR_EXPORT FormFieldText : public FormField
{
    public:
        enum TextType
        {
            Normal,        
            Multiline,     
            FileSelect     
        };

        virtual ~FormFieldText();

        virtual TextType textType() const = 0;

        virtual QString text() const = 0;

        virtual void setText( const QString& text );

        virtual bool isPassword() const;

        virtual bool isRichText() const;

        virtual int maximumLength() const;

        virtual Qt::Alignment textAlignment() const;

        virtual bool canBeSpellChecked() const;

    protected:
        FormFieldText();

    private:
        Q_DECLARE_PRIVATE( FormFieldText )
        Q_DISABLE_COPY( FormFieldText )
};


class OKULAR_EXPORT FormFieldChoice : public FormField
{
    public:
        enum ChoiceType
        {
            ComboBox,     
            ListBox       
        };

        virtual ~FormFieldChoice();

        virtual ChoiceType choiceType() const = 0;

        virtual QStringList choices() const = 0;

        virtual bool isEditable() const;

        virtual bool multiSelect() const;

        virtual QList< int > currentChoices() const = 0;

        virtual void setCurrentChoices( const QList< int >& choices );

        virtual QString editChoice() const;

        virtual void setEditChoice( const QString& text );

        virtual Qt::Alignment textAlignment() const;

        virtual bool canBeSpellChecked() const;

    protected:
        FormFieldChoice();

    private:
        Q_DECLARE_PRIVATE( FormFieldChoice )
        Q_DISABLE_COPY( FormFieldChoice )
};

}

#endif