mirror of
https://invent.kde.org/graphics/okular
synced 2024-09-19 07:51:27 +00:00
c6191c4836
Annotation: the class has been passivized. It's only a data container now, no more active manipulation of events/paints. PageViewAnnotator: this class has been created to handle creating annots. PageView creates its 'Annotator on demand. The annotator parses tool definition from the 'tool.xml' file. The Annotator internally uses AnnotatorEngine(s) to react to mouse events and the annotation is created when the job is really finished. Page: added a (maybe temporary) NormalizedPoint to complement Norm..Rect. PageViewUtils: removed PageViewEditTools and cleaned up header. conf/: added a debug option for showing annotation boundary while creating one and added a temporary 'debug' toolbox in the config dialogs. svn path=/branches/kpdf_annotations/kdegraphics/kpdf/; revision=394959
70 lines
2.6 KiB
C++
70 lines
2.6 KiB
C++
/***************************************************************************
|
|
* Copyright (C) 2005 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_PAGEVIEWANNOTATOR_H_
|
|
#define _KPDF_PAGEVIEWANNOTATOR_H_
|
|
|
|
#include <qobject.h>
|
|
#include <qdom.h>
|
|
|
|
// engines are defined and implemented in the cpp
|
|
class AnnotatorEngine;
|
|
|
|
/**
|
|
* @short PageView object devoted to annotation creation/handling.
|
|
*
|
|
* PageViewAnnotator is the kpdf class used for visually creating annotations.
|
|
* It uses internal 'engines' for interacting with user events and attaches
|
|
* the newly created annotation to the document when the creation is complete.
|
|
* In the meanwhile all PageView events (actually mouse/paint ones) are routed
|
|
* to this class that performs a rough visual representation of what the
|
|
* annotation will become when finished.
|
|
*
|
|
* "data/tools.xml" is the file that contains Annotations/Engine association
|
|
* for the items placed in the toolbar. The XML is parsed (1) when popuplating
|
|
* the toolbar and (2)after selecting a toolbar item, in which case an Ann is
|
|
* initialized with the values in the XML and an engine is created to handle
|
|
* that annotation.
|
|
*/
|
|
class PageViewAnnotator : public QObject
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
PageViewAnnotator( PageView * parent, KPDFDocument * storage );
|
|
~PageViewAnnotator();
|
|
|
|
// called to show/hide the editing toolbar
|
|
void setEnabled( bool enabled );
|
|
|
|
// methods used when creating the annotation
|
|
bool routeEvents() const;
|
|
void routeEvent( QMouseEvent * event, PageViewItem * item );
|
|
bool routePaints( const QRect & wantedRect ) const;
|
|
void routePaint( QPainter * painter, const QRect & paintRect );
|
|
|
|
private slots:
|
|
void slotToolSelected( int toolID );
|
|
void slotSaveToolbarOrientation( int side );
|
|
|
|
private:
|
|
// global class pointers
|
|
KPDFDocument * m_document;
|
|
PageView * m_pageView;
|
|
PageViewToolBar * m_toolBar;
|
|
AnnotatorEngine * m_engine;
|
|
QDomElement m_toolsDefinition;
|
|
|
|
// creation related variables
|
|
int m_lastToolID;
|
|
QRect m_lastDrawnRect;
|
|
PageViewItem * m_lockedItem;
|
|
};
|
|
|
|
#endif
|