2004-08-26 21:17:24 +00:00
|
|
|
/***************************************************************************
|
|
|
|
* Copyright (C) 2002 by Wilco Greven <greven@kde.org> *
|
|
|
|
* Copyright (C) 2003-2004 by Christophe Devriese *
|
|
|
|
* <Christophe.Devriese@student.kuleuven.ac.be> *
|
|
|
|
* Copyright (C) 2003 by Andy Goossens <andygoossens@telenet.be> *
|
|
|
|
* Copyright (C) 2003 by Laurent Montel <montel@kde.org> *
|
|
|
|
* Copyright (C) 2004 by Dominique Devriese <devriese@kde.org> *
|
2006-02-18 12:06:52 +00:00
|
|
|
* Copyright (C) 2004-2006 by Albert Astals Cid <tsdgeos@terra.es> *
|
2004-08-26 21:17:24 +00:00
|
|
|
* *
|
|
|
|
* 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. *
|
|
|
|
***************************************************************************/
|
|
|
|
|
2006-09-21 08:45:36 +00:00
|
|
|
#ifndef _PART_H_
|
|
|
|
#define _PART_H_
|
2002-08-30 09:14:01 +00:00
|
|
|
|
2002-09-02 21:56:00 +00:00
|
|
|
#include <kparts/browserextension.h>
|
2002-08-30 09:14:01 +00:00
|
|
|
#include <kparts/part.h>
|
2006-07-01 22:17:53 +00:00
|
|
|
#include <qlist.h>
|
2006-03-24 22:57:41 +00:00
|
|
|
#include <qpointer.h>
|
2005-01-02 14:55:14 +00:00
|
|
|
#include "core/observer.h"
|
2005-07-15 18:20:57 +00:00
|
|
|
#include "core/document.h"
|
2006-06-05 14:55:36 +00:00
|
|
|
|
2006-07-03 10:15:55 +00:00
|
|
|
#include <QtDBus/QtDBus>
|
2004-10-12 11:08:09 +00:00
|
|
|
|
2006-07-01 22:17:53 +00:00
|
|
|
class QAction;
|
2002-08-30 09:14:01 +00:00
|
|
|
class QWidget;
|
2004-09-11 15:59:32 +00:00
|
|
|
class QSplitter;
|
2004-09-23 21:49:00 +00:00
|
|
|
class QToolBox;
|
2002-08-30 09:14:01 +00:00
|
|
|
|
2006-03-24 21:31:46 +00:00
|
|
|
class KUrl;
|
2004-09-11 15:59:32 +00:00
|
|
|
class KAction;
|
2004-11-01 21:56:08 +00:00
|
|
|
class KConfig;
|
2004-12-01 22:18:27 +00:00
|
|
|
class KDirWatch;
|
2002-08-30 09:14:01 +00:00
|
|
|
class KToggleAction;
|
2006-05-15 22:18:52 +00:00
|
|
|
class KToggleFullScreenAction;
|
2003-09-15 21:57:19 +00:00
|
|
|
class KSelectAction;
|
2004-09-11 15:59:32 +00:00
|
|
|
class KAboutData;
|
|
|
|
class KPrinter;
|
2002-08-30 09:14:01 +00:00
|
|
|
|
2004-09-07 22:35:33 +00:00
|
|
|
class ThumbnailList;
|
2005-01-03 15:51:05 +00:00
|
|
|
class ThumbnailController;
|
2004-09-23 17:16:04 +00:00
|
|
|
class PageView;
|
2006-10-03 10:11:16 +00:00
|
|
|
class PageViewTopMessage;
|
2005-01-28 11:04:03 +00:00
|
|
|
class PresentationWidget;
|
2004-09-16 21:27:34 +00:00
|
|
|
class SearchWidget;
|
2006-02-18 12:06:52 +00:00
|
|
|
class TOC;
|
|
|
|
class MiniBar;
|
2004-09-08 12:41:14 +00:00
|
|
|
|
2006-09-21 08:45:36 +00:00
|
|
|
namespace Okular {
|
|
|
|
class Document;
|
|
|
|
class ExportEntry;
|
|
|
|
}
|
2004-10-09 08:10:56 +00:00
|
|
|
|
|
|
|
class BrowserExtension;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This is a "Part". It that does all the real work in a KPart
|
|
|
|
* application.
|
|
|
|
*
|
|
|
|
* @short Main Part
|
|
|
|
* @author Wilco Greven <greven@kde.org>
|
|
|
|
* @version 0.2
|
|
|
|
*/
|
2006-09-21 08:45:36 +00:00
|
|
|
class Part : public KParts::ReadOnlyPart, public Okular::DocumentObserver
|
2002-08-30 09:14:01 +00:00
|
|
|
{
|
2004-10-09 08:10:56 +00:00
|
|
|
Q_OBJECT
|
2006-06-12 18:25:18 +00:00
|
|
|
Q_CLASSINFO("D-Bus Interface", "org.kde.okular")
|
2004-10-09 08:10:56 +00:00
|
|
|
|
|
|
|
public:
|
|
|
|
// Default constructor
|
2006-05-08 18:57:49 +00:00
|
|
|
Part(QWidget* parentWidget, QObject* parent, const QStringList& args);
|
2002-08-30 09:14:01 +00:00
|
|
|
|
2004-10-09 08:10:56 +00:00
|
|
|
// Destructor
|
|
|
|
~Part();
|
2002-08-30 12:10:02 +00:00
|
|
|
|
2005-01-09 23:37:07 +00:00
|
|
|
// inherited from DocumentObserver
|
2004-11-09 17:20:19 +00:00
|
|
|
uint observerId() const { return PART_ID; }
|
2005-02-01 18:23:55 +00:00
|
|
|
void notifyViewportChanged( bool smoothMove );
|
2004-11-09 17:20:19 +00:00
|
|
|
|
2004-09-08 12:41:14 +00:00
|
|
|
static KAboutData* createAboutData();
|
2004-11-09 17:20:19 +00:00
|
|
|
|
2006-06-05 14:55:36 +00:00
|
|
|
public slots: // dbus
|
2006-07-03 10:15:55 +00:00
|
|
|
Q_SCRIPTABLE Q_NOREPLY void goToPage(uint page);
|
|
|
|
Q_SCRIPTABLE Q_NOREPLY void openDocument(KUrl doc);
|
2006-06-05 14:55:36 +00:00
|
|
|
Q_SCRIPTABLE uint pages();
|
|
|
|
Q_SCRIPTABLE uint currentPage();
|
|
|
|
Q_SCRIPTABLE KUrl currentDocument();
|
|
|
|
Q_SCRIPTABLE void slotPreferences();
|
|
|
|
Q_SCRIPTABLE void slotFind();
|
|
|
|
Q_SCRIPTABLE void slotPrintPreview();
|
|
|
|
Q_SCRIPTABLE void slotPreviousPage();
|
|
|
|
Q_SCRIPTABLE void slotNextPage();
|
|
|
|
Q_SCRIPTABLE void slotGotoFirst();
|
|
|
|
Q_SCRIPTABLE void slotGotoLast();
|
2004-01-02 17:46:06 +00:00
|
|
|
|
2005-11-04 11:59:51 +00:00
|
|
|
signals:
|
|
|
|
void enablePrintAction(bool enable);
|
|
|
|
|
2004-10-09 08:10:56 +00:00
|
|
|
protected:
|
2004-09-08 12:41:14 +00:00
|
|
|
// reimplemented from KParts::ReadOnlyPart
|
2004-10-09 08:10:56 +00:00
|
|
|
bool openFile();
|
2006-08-30 13:02:48 +00:00
|
|
|
bool openUrl(const KUrl &url);
|
|
|
|
bool closeUrl();
|
2005-12-07 21:25:25 +00:00
|
|
|
void supportedMimetypes();
|
2003-09-15 09:35:55 +00:00
|
|
|
|
2004-10-09 08:10:56 +00:00
|
|
|
protected slots:
|
2004-09-08 12:41:14 +00:00
|
|
|
// connected to actions
|
2006-08-30 13:02:48 +00:00
|
|
|
void openUrlFromDocument(const KUrl &url);
|
2004-09-08 12:41:14 +00:00
|
|
|
void slotGoToPage();
|
2005-01-27 17:31:07 +00:00
|
|
|
void slotHistoryBack();
|
|
|
|
void slotHistoryNext();
|
2006-06-24 10:56:06 +00:00
|
|
|
void slotPreviousBookmark();
|
|
|
|
void slotNextBookmark();
|
2004-09-08 12:41:14 +00:00
|
|
|
void slotFindNext();
|
2005-01-27 17:31:07 +00:00
|
|
|
void slotSaveFileAs();
|
2005-04-16 00:25:26 +00:00
|
|
|
void slotGetNewStuff();
|
2005-01-27 17:31:07 +00:00
|
|
|
void slotNewConfig();
|
2006-09-21 08:45:36 +00:00
|
|
|
void slotShowMenu(const Okular::Page *page, const QPoint &point);
|
2004-12-05 22:47:32 +00:00
|
|
|
void slotShowProperties();
|
2006-05-28 16:54:54 +00:00
|
|
|
void slotShowEmbeddedFiles();
|
2005-03-12 15:39:04 +00:00
|
|
|
void slotShowLeftPanel();
|
2005-01-27 17:31:07 +00:00
|
|
|
void slotShowPresentation();
|
2005-04-07 09:53:15 +00:00
|
|
|
void slotHidePresentation();
|
2006-07-01 22:17:53 +00:00
|
|
|
void slotExportAs(QAction *);
|
2005-07-15 18:20:57 +00:00
|
|
|
bool slotImportPSFile();
|
2005-11-04 11:59:51 +00:00
|
|
|
void close();
|
|
|
|
void cannotQuit();
|
2006-10-13 19:30:39 +00:00
|
|
|
void splitterMoved( int pos, int index );
|
2005-11-04 11:59:51 +00:00
|
|
|
void setMimeTypes(KIO::Job *job);
|
2006-05-28 16:54:54 +00:00
|
|
|
void saveSplitterSize();
|
2004-09-11 15:59:32 +00:00
|
|
|
// can be connected to widget elements
|
2005-02-02 18:18:26 +00:00
|
|
|
void updateViewActions();
|
2004-09-23 21:49:00 +00:00
|
|
|
void enableTOC(bool enable);
|
2004-09-08 12:41:14 +00:00
|
|
|
|
2004-10-09 08:10:56 +00:00
|
|
|
public slots:
|
2004-09-08 12:41:14 +00:00
|
|
|
// connected to Shell action (and browserExtension), not local one
|
2004-09-18 16:41:23 +00:00
|
|
|
void slotPrint();
|
2006-09-15 21:08:48 +00:00
|
|
|
void restoreDocument(KConfig* config);
|
2004-12-01 22:18:27 +00:00
|
|
|
void saveDocumentRestoreInfo(KConfig* config);
|
|
|
|
void slotFileDirty( const QString& );
|
|
|
|
void slotDoFileDirty();
|
2005-07-15 18:20:57 +00:00
|
|
|
void psTransformEnded();
|
2003-09-15 21:57:19 +00:00
|
|
|
|
2004-10-09 08:10:56 +00:00
|
|
|
private:
|
|
|
|
void doPrint( KPrinter& printer );
|
- Page/Link: tooltips for links backported
- 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
2005-08-10 16:14:39 +00:00
|
|
|
void fillGenerators();
|
2004-10-09 08:10:56 +00:00
|
|
|
|
2004-09-08 12:41:14 +00:00
|
|
|
// the document
|
2006-09-21 08:45:36 +00:00
|
|
|
Okular::Document * m_document;
|
2005-07-15 18:20:57 +00:00
|
|
|
QString m_temporaryLocalFile;
|
2004-09-08 12:41:14 +00:00
|
|
|
|
|
|
|
// main widgets
|
2004-09-11 15:59:32 +00:00
|
|
|
QSplitter *m_splitter;
|
2005-02-12 14:34:12 +00:00
|
|
|
QWidget *m_leftPanel;
|
2004-09-27 21:36:25 +00:00
|
|
|
QToolBox *m_toolBox;
|
2005-01-03 15:51:05 +00:00
|
|
|
SearchWidget *m_searchWidget;
|
2006-10-03 10:11:16 +00:00
|
|
|
PageViewTopMessage * m_topMessage;
|
2006-03-24 22:57:41 +00:00
|
|
|
QPointer<ThumbnailList> m_thumbnailList;
|
|
|
|
QPointer<PageView> m_pageView;
|
|
|
|
QPointer<TOC> m_toc;
|
|
|
|
QPointer<MiniBar> m_miniBar;
|
|
|
|
QPointer<PresentationWidget> m_presentationWidget;
|
2004-09-08 12:41:14 +00:00
|
|
|
|
2005-06-24 16:39:57 +00:00
|
|
|
// document watcher (and reloader) variables
|
2004-12-01 22:18:27 +00:00
|
|
|
KDirWatch *m_watcher;
|
|
|
|
QTimer *m_dirtyHandler;
|
2006-09-21 08:45:36 +00:00
|
|
|
Okular::DocumentViewport m_viewportDirty;
|
2006-10-15 12:26:16 +00:00
|
|
|
bool m_wasPresentationOpen;
|
2004-09-08 12:41:14 +00:00
|
|
|
|
2006-07-11 19:57:17 +00:00
|
|
|
// Remember the search history
|
|
|
|
QStringList m_searchHistory;
|
|
|
|
|
2004-09-08 12:41:14 +00:00
|
|
|
// actions
|
|
|
|
KAction *m_gotoPage;
|
|
|
|
KAction *m_prevPage;
|
|
|
|
KAction *m_nextPage;
|
|
|
|
KAction *m_firstPage;
|
|
|
|
KAction *m_lastPage;
|
2005-01-27 17:31:07 +00:00
|
|
|
KAction *m_historyBack;
|
|
|
|
KAction *m_historyNext;
|
2006-06-24 10:56:06 +00:00
|
|
|
KAction *m_prevBookmark;
|
|
|
|
KAction *m_nextBookmark;
|
2004-09-08 12:41:14 +00:00
|
|
|
KAction *m_find;
|
|
|
|
KAction *m_findNext;
|
2005-01-27 17:31:07 +00:00
|
|
|
KAction *m_saveAs;
|
|
|
|
KAction *m_printPreview;
|
2004-12-05 22:47:32 +00:00
|
|
|
KAction *m_showProperties;
|
2006-05-28 16:54:54 +00:00
|
|
|
KAction *m_showEmbeddedFiles;
|
2006-07-01 22:17:53 +00:00
|
|
|
KAction *m_exportAs;
|
|
|
|
QAction *m_exportAsText;
|
2005-01-03 15:51:05 +00:00
|
|
|
KAction *m_showPresentation;
|
2004-12-04 23:23:18 +00:00
|
|
|
KToggleAction* m_showMenuBarAction;
|
2005-03-12 15:39:04 +00:00
|
|
|
KToggleAction* m_showLeftPanel;
|
2006-05-15 22:18:52 +00:00
|
|
|
KToggleFullScreenAction* m_showFullScreenAction;
|
- GIGANTIC 2700 line diff with LOTS OF FEATURES!
- 1. editor-like text selection, and I do mean it, its not pseudo-editor
(like the ones acroread and kviewshell have) it doesnt intersect the
selection area with words under it, no, it does a lot more, including
work on cursors and searching for the text area closest to the given
cursor
- 2. rotation support, change the orientation of the documents if
you need too :)
- 3. the kfaxview backend works beautifully, porting kviewshell backends
is damn easy ! djvu and dvi will be next!
- 4. Hardware Blending of selection rectangles! We now use XRender
instead of KImageEffect, makes a damn faster blend!
- 5. Overview mode - as seen in Kviewshell, but quite a bit extended,
the kviewshell is only one state, while we support it in both
continous and non-continous form
- BTW. I coded all those features myself, (apart from kfaxview backend library)
it is an impressive bit right? but oKular cant be run by only one person,
join in on the fun! i can introduce you into the code just mail niedakh@gmail.com
svn path=/trunk/playground/graphics/oKular/kpdf/; revision=509871
2006-02-15 18:54:49 +00:00
|
|
|
|
2004-12-13 00:27:09 +00:00
|
|
|
bool m_actionsSearched;
|
2005-02-02 18:18:26 +00:00
|
|
|
bool m_searchStarted;
|
2005-06-24 16:42:44 +00:00
|
|
|
BrowserExtension *m_bExtension;
|
- Page/Link: tooltips for links backported
- 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
2005-08-10 16:14:39 +00:00
|
|
|
|
2006-09-21 08:45:36 +00:00
|
|
|
// QHash: key is the name of the generator
|
|
|
|
QHash<QString, Okular::Generator*> m_loadedGenerators;
|
|
|
|
// list of names of the generators that have settings
|
|
|
|
QStringList m_generatorsWithSettings;
|
|
|
|
QStringList m_supportedMimeTypes;
|
|
|
|
KSelectAction * m_confGens;
|
|
|
|
QList<Okular::ExportEntry*> m_exportItems;
|
- Page/Link: tooltips for links backported
- 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
2005-08-10 16:14:39 +00:00
|
|
|
|
2006-09-21 08:45:36 +00:00
|
|
|
private slots:
|
- Page/Link: tooltips for links backported
- 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
2005-08-10 16:14:39 +00:00
|
|
|
void slotGeneratorPreferences();
|
2004-10-09 08:10:56 +00:00
|
|
|
};
|
2002-09-02 21:56:00 +00:00
|
|
|
|
2003-09-14 14:22:37 +00:00
|
|
|
|
2004-10-09 08:10:56 +00:00
|
|
|
class BrowserExtension : public KParts::BrowserExtension
|
|
|
|
{
|
|
|
|
Q_OBJECT
|
|
|
|
|
|
|
|
public:
|
2004-09-08 12:41:14 +00:00
|
|
|
BrowserExtension(Part*);
|
2002-09-02 21:56:00 +00:00
|
|
|
|
2004-10-09 08:10:56 +00:00
|
|
|
public slots:
|
2004-09-08 12:41:14 +00:00
|
|
|
// Automatically detected by the host.
|
|
|
|
void print();
|
2004-10-09 08:10:56 +00:00
|
|
|
};
|
2003-09-14 14:22:37 +00:00
|
|
|
|
2002-08-30 09:14:01 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
// vim:ts=2:sw=2:tw=78:et
|