poppler-link.h

/* poppler-link.h: qt interface to poppler
 * Copyright (C) 2006, Albert Astals Cid <aacid@kde.org>
 * Copyright (C) 2007-2008, 2010, Pino Toscano <pino@kde.org>
 * Copyright (C) 2010, Guillermo Amaral <gamaral@kdab.com>
 * Adapting code from
 *   Copyright (C) 2004 by Enrico Ros <eros.kde@email.it>
 *
 * 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, or (at your option)
 * any later version.
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.
 */

#ifndef _POPPLER_LINK_H_
#define _POPPLER_LINK_H_

#include <QtCore/QString>
#include <QtCore/QRectF>
#include <QtCore/QSharedDataPointer>
#include "poppler-export.h"

namespace Poppler {

class LinkPrivate;
class LinkGotoPrivate;
class LinkExecutePrivate;
class LinkBrowsePrivate;
class LinkActionPrivate;
class LinkSoundPrivate;
class LinkJavaScriptPrivate;
class LinkMoviePrivate;
class LinkDestinationData;
class LinkDestinationPrivate;
class SoundObject;

class POPPLER_QT4_EXPORT LinkDestination
{
        public:
                enum Kind
                {
                        destXYZ = 1,
                        destFit = 2,
                        destFitH = 3,
                        destFitV = 4,
                        destFitR = 5,
                        destFitB = 6,
                        destFitBH = 7,
                        destFitBV = 8
                };

                LinkDestination(const LinkDestinationData &data);
                LinkDestination(const QString &description);

                LinkDestination(const LinkDestination &other);
                ~LinkDestination();

                // Accessors.
                Kind kind() const;
                int pageNumber() const;
                double left() const;
                double bottom() const;
                double right() const;
                double top() const;
                double zoom() const;
                bool isChangeLeft() const;
                bool isChangeTop() const;
                bool isChangeZoom() const;

                QString toString() const;

                QString destinationName() const;

                LinkDestination& operator=(const LinkDestination &other);

        private:
                QSharedDataPointer< LinkDestinationPrivate > d;
};

class POPPLER_QT4_EXPORT Link
{
        public:
                Link( const QRectF &linkArea );
                
                enum LinkType
                {
                    None,     
                    Goto,     
                    Execute,  
                    Browse,   
                    Action,   
                    Sound,    
                    Movie,    
                    JavaScript    
                };

                virtual LinkType linkType() const;

                virtual ~Link();
                
                QRectF linkArea() const;
                
        protected:
                Link( LinkPrivate &dd );
                Q_DECLARE_PRIVATE( Link )
                LinkPrivate *d_ptr;
                
        private:
                Q_DISABLE_COPY( Link )
};


class POPPLER_QT4_EXPORT LinkGoto : public Link
{
        public:
                LinkGoto( const QRectF &linkArea, QString extFileName, const LinkDestination & destination );
                ~LinkGoto();

                bool isExternal() const;
                // query for goto parameters
                QString fileName() const;
                LinkDestination destination() const;
                LinkType linkType() const;

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

class POPPLER_QT4_EXPORT LinkExecute : public Link
{
        public:
                QString fileName() const;
                QString parameters() const;

                LinkExecute( const QRectF &linkArea, const QString & file, const QString & params );
                ~LinkExecute();
                LinkType linkType() const;

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

class POPPLER_QT4_EXPORT LinkBrowse : public Link
{
        public:
                QString url() const;

                LinkBrowse( const QRectF &linkArea, const QString &url );
                ~LinkBrowse();
                LinkType linkType() const;

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

class POPPLER_QT4_EXPORT LinkAction : public Link
{
        public:
                enum ActionType { PageFirst = 1,
                                  PagePrev = 2,
                                  PageNext = 3,
                                  PageLast = 4,
                                  HistoryBack = 5,
                                  HistoryForward = 6,
                                  Quit = 7,
                                  Presentation = 8,
                                  EndPresentation = 9,
                                  Find = 10,
                                  GoToPage = 11,
                                  Close = 12,
                                  Print = 13    
                };

                ActionType actionType() const;

                LinkAction( const QRectF &linkArea, ActionType actionType );
                ~LinkAction();
                LinkType linkType() const;

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

class POPPLER_QT4_EXPORT LinkSound : public Link
{
        public:
                // create a Link_Sound
                LinkSound( const QRectF &linkArea, double volume, bool sync, bool repeat, bool mix, SoundObject *sound );
                virtual ~LinkSound();

                LinkType linkType() const;

                double volume() const;
                bool synchronous() const;
                bool repeat() const;
                bool mix() const;
                SoundObject *sound() const;

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

class POPPLER_QT4_EXPORT LinkJavaScript : public Link
{
        public:
                LinkJavaScript( const QRectF &linkArea, const QString &js );
                virtual ~LinkJavaScript();

                LinkType linkType() const;

                QString script() const;

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

#if 0

class POPPLER_QT4_EXPORT LinkMovie : public Link
// TODO this (Movie link)
{
        public:
                LinkMovie( const QRectF &linkArea );
                ~LinkMovie();
                LinkType linkType() const;

        private:
                Q_DECLARE_PRIVATE( LinkMovie )
                Q_DISABLE_COPY( LinkMovie )
};
#endif

}

#endif