mirror of
https://invent.kde.org/graphics/okular
synced 2024-11-05 18:34:53 +00:00
34b8e28322
- Page: rotation does not switch height and width
- Document/Part/Generator:
1. Add API for attaching stuff to the interface: ActionCollection and the Navigation Panel
also add possibility to merge an XML .rc file with menu layout. Relevant functions are:
QString Generator::getXMLFile(), returns a QString with your .rc file name.
void Generator::setupGUI (KActionCollection* , QToolbox* ), add your components to the user interface
2. Supporting backend settings:
If during startup, backends which provide a configuration ([X-KDE-oKularHasInternalSettings]
set to true) are found, a menu item: configure backends is created, clicking on it results in
loading all the generators that have settings, but not those that dont. the Generator::addPages(KConfigDialog *dlg)
function should be overloaded by a generator and dlg->addPage should be used to add pages.
If a user opens a file that needs an already loaded generator, the already loaded one is used instead of loading another.
3. Error/Warning/Notice sending support, to send a notice/error/warning, add a relevant notice/error/warning(QString& txt ,int duration)
to the generator class, and sending a message to the user is as simple as emitting a signal!
4. Intercepting of events generated by the PageView is done by Generator::handleEvent(QEvent*), subclass it, do a switch on QEvent::type(), handle your
event and return true if pageview is to proceed with its handling or false if not.
5. Support configuring the KPrinter on the generator side, use Generator::canConfigurePrinter(), return true there, and you get a nonconfigured KPrinter in your
Generator::print()
6. PixmapRequest handling update:
a.) Generator::canGeneratePixmap is now Generator::canGeneratePixmap(bool async)
b.) Document::sendGeneratorRequests is a slot now
c.) Old way of sending pixmaps (Document::requestPixmaps(QValueList<PixmapRequest*> checking if we can generate pixmap if not, waiting for receiving)
is replaced with: requestPixmaps only queues the pixmap all checking if w can generate is done in sendGeneratorReqest, the sendGeneratorRequest is
run in three places:
1. in requestPixmaps when we receive a request
2. in requestDone if pixmapStack is not empty
3. sendGeneratorRequest, apart from removing invalid requests, takes the current request and if generator canGeratePixmap(request->async)
it removes the pixmap from stack and sends to generator if not, QTimer::singleshots to itself after 20ms, it ends when stack has no valid pixmap request
7. Added a commented out zoom field to PixmapGenerator, mightcome in handy sometime
- TextPage: add instructions that handle simplyfing the RegularAreaRect, no more double painted borders in selection rectangles, this rocks.
svn path=/trunk/playground/graphics/oKular/kpdf/; revision=445196
119 lines
3.9 KiB
C++
119 lines
3.9 KiB
C++
/***************************************************************************
|
|
* 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 of the License, or *
|
|
* (at your option) any later version. *
|
|
***************************************************************************/
|
|
|
|
#ifndef _KPDF_LINK_H_
|
|
#define _KPDF_LINK_H_
|
|
|
|
#include <qstring.h>
|
|
#include <qrect.h>
|
|
#include "core/document.h" // for DocumentViewport
|
|
|
|
/**
|
|
* @short Encapsulates data that describes a link.
|
|
*
|
|
* This is the base class for links. It makes mandatory for inherited
|
|
* widgets to reimplement the 'linkType' method and return the type of
|
|
* the link described by the reimplemented class.
|
|
*/
|
|
class KPDFLink
|
|
{
|
|
public:
|
|
// get link type (inherited classes mustreturn an unique identifier)
|
|
enum LinkType { Goto, Execute, Browse, Action, Movie };
|
|
virtual LinkType linkType() const = 0;
|
|
virtual QString linkTip() const;
|
|
|
|
// virtual destructor (remove warnings)
|
|
virtual ~KPDFLink();
|
|
};
|
|
|
|
|
|
/** Goto: a viewport and maybe a reference to an external filename **/
|
|
class KPDFLinkGoto : public KPDFLink
|
|
{
|
|
public:
|
|
// query for goto parameters
|
|
bool isExternal() const { return !m_extFileName.isEmpty(); }
|
|
const QString & fileName() const { return m_extFileName; }
|
|
const DocumentViewport & destViewport() const { return m_vp; }
|
|
|
|
// create a KPDFLink_Goto
|
|
KPDFLinkGoto( QString extFileName, const DocumentViewport & vp ) { m_extFileName = extFileName; m_vp = vp; }
|
|
LinkType linkType() const { return Goto; }
|
|
QString linkTip() const;
|
|
|
|
private:
|
|
QString m_extFileName;
|
|
DocumentViewport m_vp;
|
|
};
|
|
|
|
/** Execute: filename and parameters to execute **/
|
|
class KPDFLinkExecute : public KPDFLink
|
|
{
|
|
public:
|
|
// query for filename / parameters
|
|
const QString & fileName() const { return m_fileName; }
|
|
const QString & parameters() const { return m_parameters; }
|
|
|
|
// create a KPDFLink_Execute
|
|
KPDFLinkExecute( const QString & file, const QString & params ) { m_fileName = file; m_parameters = params; }
|
|
LinkType linkType() const { return Execute; }
|
|
QString linkTip() const;
|
|
|
|
private:
|
|
QString m_fileName;
|
|
QString m_parameters;
|
|
};
|
|
|
|
/** Browse: an URL to open, ranging from 'http://' to 'mailto:' etc.. **/
|
|
class KPDFLinkBrowse : public KPDFLink
|
|
{
|
|
public:
|
|
// query for URL
|
|
const QString & url() const { return m_url; }
|
|
|
|
// create a KPDFLink_Browse
|
|
KPDFLinkBrowse( const QString &url ) { m_url = url; }
|
|
LinkType linkType() const { return Browse; }
|
|
QString linkTip() const;
|
|
|
|
private:
|
|
QString m_url;
|
|
};
|
|
|
|
/** Action: contains an action to perform on document / kpdf **/
|
|
class KPDFLinkAction : public KPDFLink
|
|
{
|
|
public:
|
|
// define types of actions
|
|
enum ActionType { PageFirst, PagePrev, PageNext, PageLast, HistoryBack, HistoryForward,
|
|
Quit, Presentation, EndPresentation, Find, GoToPage };
|
|
|
|
// query for action type
|
|
ActionType actionType() const { return m_type; }
|
|
|
|
// create a KPDFLink_Action
|
|
KPDFLinkAction( enum ActionType actionType ) { m_type = actionType; }
|
|
LinkType linkType() const { return Action; }
|
|
QString linkTip() const;
|
|
|
|
private:
|
|
ActionType m_type;
|
|
};
|
|
|
|
/** Movie: Not yet defined -> think renaming to 'Media' link **/
|
|
class KPDFLinkMovie : public KPDFLink
|
|
// TODO this (Movie link)
|
|
{
|
|
public:
|
|
KPDFLinkMovie() {};
|
|
LinkType linkType() const { return Movie; }
|
|
};
|
|
|
|
#endif
|