mirror of
https://invent.kde.org/graphics/okular
synced 2024-10-30 06:46:01 +00:00
8941e43488
QLinkedList is gone from Qt6 The 1:1 port is std::list but we don't need iterator stability on removal/insertion so just port to QList (one case to std::vector since QList needs a copy constructor)
1778 lines
43 KiB
C++
1778 lines
43 KiB
C++
/*
|
|
SPDX-FileCopyrightText: 2005 Enrico Ros <eros.kde@email.it>
|
|
|
|
SPDX-License-Identifier: GPL-2.0-or-later
|
|
*/
|
|
|
|
#ifndef _OKULAR_ANNOTATIONS_H_
|
|
#define _OKULAR_ANNOTATIONS_H_
|
|
|
|
#include <QDateTime>
|
|
#include <QDomDocument>
|
|
#include <QDomElement>
|
|
#include <QFont>
|
|
#include <QRect>
|
|
#include <QString>
|
|
|
|
#include "area.h"
|
|
#include "okularcore_export.h"
|
|
|
|
namespace Okular
|
|
{
|
|
class Action;
|
|
class Annotation;
|
|
class AnnotationObjectRect;
|
|
class AnnotationPrivate;
|
|
class Document;
|
|
class EmbeddedFile;
|
|
class Page;
|
|
class PagePrivate;
|
|
class Sound;
|
|
class Movie;
|
|
class TextAnnotationPrivate;
|
|
class LineAnnotationPrivate;
|
|
class GeomAnnotationPrivate;
|
|
class HighlightAnnotationPrivate;
|
|
class StampAnnotationPrivate;
|
|
class InkAnnotationPrivate;
|
|
class CaretAnnotationPrivate;
|
|
class FileAttachmentAnnotationPrivate;
|
|
class SoundAnnotationPrivate;
|
|
class MovieAnnotationPrivate;
|
|
class ScreenAnnotationPrivate;
|
|
class WidgetAnnotationPrivate;
|
|
class RichMediaAnnotationPrivate;
|
|
|
|
/**
|
|
* @short Helper class for (recursive) annotation retrieval/storage.
|
|
*/
|
|
class OKULARCORE_EXPORT AnnotationUtils
|
|
{
|
|
public:
|
|
/**
|
|
* Restore an annotation (with revisions if needed) from the dom @p element.
|
|
*
|
|
* Returns a pointer to the complete annotation or 0 if element is invalid.
|
|
*/
|
|
static Annotation *createAnnotation(const QDomElement &element);
|
|
|
|
/**
|
|
* Saves the @p annotation as a child of @p element taking
|
|
* care of saving all revisions if it has any.
|
|
*/
|
|
static void storeAnnotation(const Annotation *annotation, QDomElement &element, QDomDocument &document);
|
|
|
|
/**
|
|
* Returns the child element with the given @p name from the direct
|
|
* children of @p parentNode or a null element if not found.
|
|
*/
|
|
static QDomElement findChildElement(const QDomNode &parentNode, const QString &name);
|
|
|
|
/**
|
|
* Returns the geometry of the given @p annotation scaled by
|
|
* @p scaleX and @p scaleY.
|
|
*/
|
|
static QRect annotationGeometry(const Annotation *annotation, double scaleX, double scaleY);
|
|
|
|
/**
|
|
* Returns a pixmap for a stamp symbol
|
|
*
|
|
* @p name Name of a Okular stamp symbol, icon or path to an image
|
|
* @p size Size of the pixmap side
|
|
* @p keepAspectRatio Whether to keep aspect ratio of the stamp or not
|
|
*
|
|
* @since 21.12
|
|
*/
|
|
static QPixmap loadStamp(const QString &nameOrPath, int size, bool keepAspectRatio = true);
|
|
};
|
|
|
|
/**
|
|
* @short Annotation struct holds properties shared by all annotations.
|
|
*
|
|
* An Annotation is an object (text note, highlight, sound, popup window, ..)
|
|
* contained by a Page in the document.
|
|
*/
|
|
class OKULARCORE_EXPORT Annotation
|
|
{
|
|
/// @cond PRIVATE
|
|
friend class AnnotationObjectRect;
|
|
friend class Document;
|
|
friend class DocumentPrivate;
|
|
friend class ObjectRect;
|
|
friend class Page;
|
|
friend class PagePrivate;
|
|
/// @endcond
|
|
|
|
public:
|
|
/**
|
|
* Describes the type of annotation as defined in PDF standard.
|
|
*/
|
|
enum SubType {
|
|
AText = 1, ///< A textual annotation
|
|
ALine = 2, ///< A line annotation
|
|
AGeom = 3, ///< A geometrical annotation
|
|
AHighlight = 4, ///< A highlight annotation
|
|
AStamp = 5, ///< A stamp annotation
|
|
AInk = 6, ///< An ink annotation
|
|
ACaret = 8, ///< A caret annotation
|
|
AFileAttachment = 9, ///< A file attachment annotation
|
|
ASound = 10, ///< A sound annotation
|
|
AMovie = 11, ///< A movie annotation
|
|
AScreen = 12, ///< A screen annotation
|
|
AWidget = 13, ///< A widget annotation
|
|
ARichMedia = 14, ///< A rich media annotation
|
|
A_BASE = 0 ///< The annotation base class
|
|
};
|
|
|
|
/**
|
|
* Describes additional properties of an annotation.
|
|
*/
|
|
enum Flag {
|
|
Hidden = 1, ///< Is not shown in the document
|
|
FixedSize = 2, ///< Has a fixed size
|
|
FixedRotation = 4, ///< Has a fixed rotation
|
|
DenyPrint = 8, ///< Cannot be printed
|
|
DenyWrite = 16, ///< Cannot be changed
|
|
DenyDelete = 32, ///< Cannot be deleted
|
|
ToggleHidingOnMouse = 64, ///< Can be hidden/shown by mouse click
|
|
External = 128, ///< Is stored external
|
|
ExternallyDrawn = 256, ///< Is drawn externally (by the generator which provided it) @since 0.10 (KDE 4.4)
|
|
BeingMoved = 512, ///< Is being moved (mouse drag and drop). If ExternallyDrawn, the generator must not draw it @since 0.15 (KDE 4.9)
|
|
BeingResized = 1024 ///< Is being resized (mouse drag and drop). If ExternallyDrawn, the generator must not draw it @since 1.1.0
|
|
};
|
|
|
|
/**
|
|
* Describes possible line styles for @see ALine annotation.
|
|
*/
|
|
enum LineStyle {
|
|
Solid = 1, ///< A solid line
|
|
Dashed = 2, ///< A dashed line
|
|
Beveled = 4, ///< A beveled line
|
|
Inset = 8, ///< An inset line
|
|
Underline = 16 ///< An underline
|
|
};
|
|
|
|
/**
|
|
* Describes possible line effects for @see ALine annotation.
|
|
*/
|
|
enum LineEffect {
|
|
NoEffect = 1, ///< No effect
|
|
Cloudy = 2 ///< The cloudy effect
|
|
};
|
|
|
|
/**
|
|
* Describes the scope of revision information.
|
|
*/
|
|
enum RevisionScope {
|
|
Reply = 1, ///< Belongs to a reply
|
|
Group = 2, ///< Belongs to a group
|
|
Delete = 4 ///< Belongs to a deleted paragraph
|
|
};
|
|
|
|
/**
|
|
* Describes the type of revision information.
|
|
*/
|
|
enum RevisionType {
|
|
None = 1, ///< Not specified
|
|
Marked = 2, ///< Is marked
|
|
Unmarked = 4, ///< Is unmarked
|
|
Accepted = 8, ///< Has been accepted
|
|
Rejected = 16, ///< Was rejected
|
|
Cancelled = 32, ///< Has been cancelled
|
|
Completed = 64 ///< Has been completed
|
|
};
|
|
|
|
/**
|
|
* Describes the type of additional actions.
|
|
*
|
|
* @since 0.16 (KDE 4.10)
|
|
*/
|
|
enum AdditionalActionType {
|
|
PageOpening, ///< Performed when the page containing the annotation is opened.
|
|
PageClosing, ///< Performed when the page containing the annotation is closed.
|
|
CursorEntering, ///< Performed when the cursor enters the annotation's active area @since 1.5
|
|
CursorLeaving, ///< Performed when the cursor exists the annotation's active area @since 1.5
|
|
MousePressed, ///< Performed when the mouse button is pressed inside the annotation's active area @since 1.5
|
|
MouseReleased, ///< Performed when the mouse button is released inside the annotation's active area @since 1.5
|
|
FocusIn, ///< Performed when the annotation receives the input focus @since 1.5
|
|
FocusOut, ///< Performed when the annotation loses the input focus @since 1.5
|
|
};
|
|
|
|
/**
|
|
* A function to be called when the annotation is destroyed.
|
|
*
|
|
* @warning the function must *not* call any virtual function,
|
|
* nor subcast.
|
|
*
|
|
* @since 0.7 (KDE 4.1)
|
|
*/
|
|
typedef void (*DisposeDataFunction)(const Okular::Annotation *);
|
|
|
|
/**
|
|
* Destroys the annotation.
|
|
*/
|
|
virtual ~Annotation();
|
|
|
|
/**
|
|
* Sets the @p author of the annotation.
|
|
*/
|
|
void setAuthor(const QString &author);
|
|
|
|
/**
|
|
* Returns the author of the annotation.
|
|
*/
|
|
QString author() const;
|
|
|
|
/**
|
|
* Sets the @p contents of the annotation.
|
|
*/
|
|
void setContents(const QString &contents);
|
|
|
|
/**
|
|
* Returns the contents of the annotation.
|
|
*/
|
|
QString contents() const;
|
|
|
|
/**
|
|
* Sets the unique @p name of the annotation.
|
|
*/
|
|
void setUniqueName(const QString &name);
|
|
|
|
/**
|
|
* Returns the unique name of the annotation.
|
|
*/
|
|
QString uniqueName() const;
|
|
|
|
/**
|
|
* Sets the last modification @p date of the annotation.
|
|
*
|
|
* The date must be before or equal to QDateTime::currentDateTime()
|
|
*/
|
|
void setModificationDate(const QDateTime &date);
|
|
|
|
/**
|
|
* Returns the last modification date of the annotation.
|
|
*/
|
|
QDateTime modificationDate() const;
|
|
|
|
/**
|
|
* Sets the creation @p date of the annotation.
|
|
*
|
|
* The date must be before or equal to @see modificationDate()
|
|
*/
|
|
void setCreationDate(const QDateTime &date);
|
|
|
|
/**
|
|
* Returns the creation date of the annotation.
|
|
*/
|
|
QDateTime creationDate() const;
|
|
|
|
/**
|
|
* Sets the @p flags of the annotation.
|
|
* @see @ref Flag
|
|
*/
|
|
void setFlags(int flags);
|
|
|
|
/**
|
|
* Returns the flags of the annotation.
|
|
* @see @ref Flag
|
|
*/
|
|
int flags() const;
|
|
|
|
/**
|
|
* Sets the bounding @p rectangle of the annotation.
|
|
*/
|
|
void setBoundingRectangle(const NormalizedRect &rectangle);
|
|
|
|
/**
|
|
* Returns the bounding rectangle of the annotation.
|
|
*/
|
|
NormalizedRect boundingRectangle() const;
|
|
|
|
/**
|
|
* Returns the transformed bounding rectangle of the annotation.
|
|
*
|
|
* This rectangle must be used when showing annotations on screen
|
|
* to have them rotated correctly.
|
|
*/
|
|
NormalizedRect transformedBoundingRectangle() const;
|
|
|
|
/**
|
|
* Move the annotation by the specified coordinates.
|
|
*
|
|
* @see canBeMoved()
|
|
*/
|
|
void translate(const NormalizedPoint &coord);
|
|
|
|
/**
|
|
* Adjust the annotation by the specified coordinates.
|
|
* Adds coordinates of @p deltaCoord1 to annotations top left corner,
|
|
* and @p deltaCoord2 to the bottom right.
|
|
*
|
|
* @see canBeResized()
|
|
*/
|
|
void adjust(const NormalizedPoint &deltaCoord1, const NormalizedPoint &deltaCoord2);
|
|
|
|
/**
|
|
* The Style class contains all information about style of the
|
|
* annotation.
|
|
*/
|
|
class OKULARCORE_EXPORT Style
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new style.
|
|
*/
|
|
Style();
|
|
|
|
/**
|
|
* Destroys the style.
|
|
*/
|
|
~Style();
|
|
|
|
Style(const Style &other);
|
|
Style &operator=(const Style &other);
|
|
|
|
/**
|
|
* Sets the @p color of the style.
|
|
*/
|
|
void setColor(const QColor &color);
|
|
|
|
/**
|
|
* Returns the color of the style.
|
|
*/
|
|
QColor color() const;
|
|
|
|
/**
|
|
* Sets the @p opacity of the style.
|
|
*/
|
|
void setOpacity(double opacity);
|
|
|
|
/**
|
|
* Returns the opacity of the style.
|
|
*/
|
|
double opacity() const;
|
|
|
|
/**
|
|
* Sets the @p width of the style.
|
|
*/
|
|
void setWidth(double width);
|
|
|
|
/**
|
|
* Returns the width of the style.
|
|
*/
|
|
double width() const;
|
|
|
|
/**
|
|
* Sets the line @p style of the style.
|
|
*/
|
|
void setLineStyle(LineStyle style);
|
|
|
|
/**
|
|
* Returns the line style of the style.
|
|
*/
|
|
LineStyle lineStyle() const;
|
|
|
|
/**
|
|
* Sets the x-corners of the style.
|
|
*/
|
|
void setXCorners(double xCorners);
|
|
|
|
/**
|
|
* Returns the x-corners of the style.
|
|
*/
|
|
double xCorners() const;
|
|
|
|
/**
|
|
* Sets the y-corners of the style.
|
|
*/
|
|
void setYCorners(double yCorners);
|
|
|
|
/**
|
|
* Returns the y-corners of the style.
|
|
*/
|
|
double yCorners() const;
|
|
|
|
/**
|
|
* Sets the @p marks of the style.
|
|
*/
|
|
void setMarks(int marks);
|
|
|
|
/**
|
|
* Returns the marks of the style.
|
|
*/
|
|
int marks() const;
|
|
|
|
/**
|
|
* Sets the @p spaces of the style.
|
|
*/
|
|
void setSpaces(int spaces);
|
|
|
|
/**
|
|
* Returns the spaces of the style.
|
|
*/
|
|
int spaces() const;
|
|
|
|
/**
|
|
* Sets the line @p effect of the style.
|
|
*/
|
|
void setLineEffect(LineEffect effect);
|
|
|
|
/**
|
|
* Returns the line effect of the style.
|
|
*/
|
|
LineEffect lineEffect() const;
|
|
|
|
/**
|
|
* Sets the effect @p intensity of the style.
|
|
*/
|
|
void setEffectIntensity(double intensity);
|
|
|
|
/**
|
|
* Returns the effect intensity of the style.
|
|
*/
|
|
double effectIntensity() const;
|
|
|
|
private:
|
|
class Private;
|
|
Private *const d;
|
|
};
|
|
|
|
/**
|
|
* Returns a reference to the style object of the annotation.
|
|
*/
|
|
Style &style();
|
|
|
|
/**
|
|
* Returns a const reference to the style object of the annotation.
|
|
*/
|
|
const Style &style() const;
|
|
|
|
/**
|
|
* The Window class contains all information about the popup window
|
|
* of the annotation that is used to edit the content and properties.
|
|
*/
|
|
class OKULARCORE_EXPORT Window
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new window.
|
|
*/
|
|
Window();
|
|
|
|
/**
|
|
* Destroys the window.
|
|
*/
|
|
~Window();
|
|
|
|
Window(const Window &other);
|
|
Window &operator=(const Window &other);
|
|
|
|
/**
|
|
* Sets the @p flags of the window.
|
|
*/
|
|
void setFlags(int flags);
|
|
|
|
/**
|
|
* Returns the flags of the window.
|
|
*/
|
|
int flags() const;
|
|
|
|
/**
|
|
* Sets the top-left @p point of the window.
|
|
*/
|
|
void setTopLeft(const NormalizedPoint &point);
|
|
|
|
/**
|
|
* Returns the top-left point of the window.
|
|
*/
|
|
NormalizedPoint topLeft() const;
|
|
|
|
/**
|
|
* Sets the @p width of the window.
|
|
*/
|
|
void setWidth(int width);
|
|
|
|
/**
|
|
* Returns the width of the window.
|
|
*/
|
|
int width() const;
|
|
|
|
/**
|
|
* Sets the @p height of the window.
|
|
*/
|
|
void setHeight(int height);
|
|
|
|
/**
|
|
* Returns the height of the window.
|
|
*/
|
|
int height() const;
|
|
|
|
/**
|
|
* Sets the @p title of the window.
|
|
*/
|
|
void setTitle(const QString &title);
|
|
|
|
/**
|
|
* Returns the title of the window.
|
|
*/
|
|
QString title() const;
|
|
|
|
/**
|
|
* Sets the @p summary of the window.
|
|
*/
|
|
void setSummary(const QString &summary);
|
|
|
|
/**
|
|
* Returns the summary of the window.
|
|
*/
|
|
QString summary() const;
|
|
|
|
private:
|
|
class Private;
|
|
Private *const d;
|
|
};
|
|
|
|
/**
|
|
* Returns a reference to the window object of the annotation.
|
|
*/
|
|
Window &window();
|
|
|
|
/**
|
|
* Returns a const reference to the window object of the annotation.
|
|
*/
|
|
const Window &window() const;
|
|
|
|
/**
|
|
* The Revision class contains all information about the revision
|
|
* of the annotation.
|
|
*/
|
|
class OKULARCORE_EXPORT Revision
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new revision.
|
|
*/
|
|
Revision();
|
|
|
|
/**
|
|
* Destroys the revision.
|
|
*/
|
|
~Revision();
|
|
|
|
Revision(const Revision &other);
|
|
Revision &operator=(const Revision &other);
|
|
|
|
/**
|
|
* Sets the @p annotation the revision belongs to.
|
|
*/
|
|
void setAnnotation(Annotation *annotation);
|
|
|
|
/**
|
|
* Returns the annotation the revision belongs to.
|
|
*/
|
|
Annotation *annotation() const;
|
|
|
|
/**
|
|
* Sets the @p scope of the revision.
|
|
* @see RevisionScope
|
|
*/
|
|
void setScope(RevisionScope scope);
|
|
|
|
/**
|
|
* Returns the scope of the revision.
|
|
*/
|
|
RevisionScope scope() const;
|
|
|
|
/**
|
|
* Sets the @p type of the revision.
|
|
* @see RevisionType
|
|
*/
|
|
void setType(RevisionType type);
|
|
|
|
/**
|
|
* Returns the type of the revision.
|
|
*/
|
|
RevisionType type() const;
|
|
|
|
private:
|
|
class Private;
|
|
Private *const d;
|
|
};
|
|
|
|
/**
|
|
* Returns a reference to the revision list of the annotation.
|
|
*/
|
|
QList<Revision> &revisions();
|
|
|
|
/**
|
|
* Returns a reference to the revision list of the annotation.
|
|
*/
|
|
const QList<Revision> &revisions() const;
|
|
|
|
/**
|
|
* Sets the "native" @p id of the annotation.
|
|
*
|
|
* This is for use of the Generator, that can optionally store an
|
|
* handle (a pointer, an identifier, etc) of the "native" annotation
|
|
* object, if any.
|
|
*
|
|
* @note Okular makes no use of this
|
|
*
|
|
* @since 0.7 (KDE 4.1)
|
|
*/
|
|
void setNativeId(const QVariant &id);
|
|
|
|
/**
|
|
* Returns the "native" id of the annotation.
|
|
*
|
|
* @since 0.7 (KDE 4.1)
|
|
*/
|
|
QVariant nativeId() const;
|
|
|
|
/**
|
|
* Sets a function to be called when the annotation is destroyed.
|
|
*
|
|
* @warning the function must *not* call any virtual function,
|
|
* nor subcast.
|
|
*
|
|
* @since 0.7 (KDE 4.1)
|
|
*/
|
|
void setDisposeDataFunction(DisposeDataFunction func);
|
|
|
|
/**
|
|
* Returns whether the annotation can be moved.
|
|
*
|
|
* @since 0.7 (KDE 4.1)
|
|
*/
|
|
bool canBeMoved() const;
|
|
|
|
/**
|
|
* Returns whether the annotation can be resized.
|
|
*/
|
|
bool canBeResized() const;
|
|
|
|
/**
|
|
* Returns whether the annotation dialog should be open after creation of the annotation or not
|
|
*
|
|
* @since 0.13 (KDE 4.7)
|
|
*/
|
|
bool openDialogAfterCreation() const;
|
|
|
|
/**
|
|
* Returns the sub type of the annotation.
|
|
*/
|
|
virtual SubType subType() const = 0;
|
|
|
|
/**
|
|
* Stores the annotation as xml in @p document under the given parent @p node.
|
|
*/
|
|
virtual void store(QDomNode &node, QDomDocument &document) const;
|
|
|
|
/**
|
|
* Retrieve the QDomNode representing this annotation's properties
|
|
|
|
* @since 0.17 (KDE 4.11)
|
|
*/
|
|
QDomNode getAnnotationPropertiesDomNode() const;
|
|
|
|
/**
|
|
* Sets annotations internal properties according to the contents of @p node
|
|
*
|
|
* @since 0.17 (KDE 4.11)
|
|
*/
|
|
void setAnnotationProperties(const QDomNode &node);
|
|
|
|
protected:
|
|
/// @cond PRIVATE
|
|
explicit Annotation(AnnotationPrivate &dd);
|
|
Annotation(AnnotationPrivate &dd, const QDomNode &description);
|
|
Q_DECLARE_PRIVATE(Annotation)
|
|
AnnotationPrivate *d_ptr;
|
|
/// @endcond
|
|
|
|
private:
|
|
Q_DISABLE_COPY(Annotation)
|
|
};
|
|
|
|
/**
|
|
* @short Native annotation interface
|
|
*
|
|
* Generators can subclass it to provide native annotation support.
|
|
* Generators can use Annotation::setNativeId to store per-annotation data.
|
|
*
|
|
* @since 0.15 (KDE 4.9)
|
|
*/
|
|
class OKULARCORE_EXPORT AnnotationProxy
|
|
{
|
|
public:
|
|
enum Capability {
|
|
Addition, ///< Generator can create native annotations
|
|
Modification, ///< Generator can edit native annotations
|
|
Removal ///< Generator can remove native annotations
|
|
};
|
|
|
|
AnnotationProxy();
|
|
|
|
/**
|
|
* Destroys the annotation proxy.
|
|
*/
|
|
virtual ~AnnotationProxy();
|
|
|
|
AnnotationProxy(const AnnotationProxy &) = delete;
|
|
AnnotationProxy &operator=(const AnnotationProxy &) = delete;
|
|
|
|
/**
|
|
* Query for the supported capabilities.
|
|
*/
|
|
virtual bool supports(Capability capability) const = 0;
|
|
|
|
/**
|
|
* Called when a new @p annotation is added to a @p page.
|
|
*
|
|
* @note Only called if supports(Addition) == true
|
|
*/
|
|
virtual void notifyAddition(Annotation *annotation, int page) = 0;
|
|
|
|
/**
|
|
* Called after an existing @p annotation at a given @p page is modified.
|
|
*
|
|
* Generator can call @p annotation getters to get the new values.
|
|
* @p appearanceChanged tells if a non-visible property was modified
|
|
*
|
|
* @note Only called if supports(Modification) == true
|
|
*/
|
|
virtual void notifyModification(const Annotation *annotation, int page, bool appearanceChanged) = 0;
|
|
|
|
/**
|
|
* Called when an existing @p annotation at a given @p page is removed.
|
|
*
|
|
* @note Only called if supports(Removal) == true
|
|
*/
|
|
virtual void notifyRemoval(Annotation *annotation, int page) = 0;
|
|
};
|
|
|
|
class OKULARCORE_EXPORT TextAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Describes the type of the text.
|
|
*/
|
|
enum TextType {
|
|
Linked, ///< The annotation is linked to a text
|
|
InPlace ///< The annotation is located next to the text
|
|
};
|
|
|
|
/**
|
|
* Describes the style of the text.
|
|
*/
|
|
enum InplaceIntent {
|
|
Unknown, ///< Unknown style
|
|
Callout, ///< Callout style
|
|
TypeWriter ///< Type writer style
|
|
};
|
|
|
|
/**
|
|
* Creates a new text annotation.
|
|
*/
|
|
TextAnnotation();
|
|
|
|
/**
|
|
* Creates a new text annotation from the xml @p description
|
|
*/
|
|
explicit TextAnnotation(const QDomNode &description);
|
|
|
|
/**
|
|
* Destroys the text annotation.
|
|
*/
|
|
~TextAnnotation() override;
|
|
|
|
/**
|
|
* Sets the text @p type of the text annotation.
|
|
* @see TextType
|
|
*/
|
|
void setTextType(TextType type);
|
|
|
|
/**
|
|
* Returns the text type of the text annotation.
|
|
*/
|
|
TextType textType() const;
|
|
|
|
/**
|
|
* Sets the @p icon of the text annotation.
|
|
*/
|
|
void setTextIcon(const QString &icon);
|
|
|
|
/**
|
|
* Returns the icon of the text annotation.
|
|
*/
|
|
QString textIcon() const;
|
|
|
|
/**
|
|
* Sets the @p font of the text annotation.
|
|
*/
|
|
void setTextFont(const QFont &font);
|
|
|
|
/**
|
|
* Returns the font of the text annotation.
|
|
*/
|
|
QFont textFont() const;
|
|
|
|
/**
|
|
* Sets the @p color of inplace text.
|
|
*
|
|
* @since 1.6
|
|
*/
|
|
void setTextColor(const QColor &color);
|
|
|
|
/**
|
|
* Returns the color of inplace text.
|
|
*
|
|
* @since 1.6
|
|
*/
|
|
QColor textColor() const;
|
|
|
|
/**
|
|
* Sets the inplace @p alignment of the text annotation.
|
|
* 0:left, 1:center, 2:right
|
|
*/
|
|
void setInplaceAlignment(int alignment);
|
|
|
|
/**
|
|
* Returns the inplace alignment of the text annotation.
|
|
* 0:left, 1:center, 2:right
|
|
*/
|
|
int inplaceAlignment() const;
|
|
|
|
/**
|
|
* Sets the inplace callout @p point at @p index.
|
|
*
|
|
* @p index must be between 0 and 2.
|
|
*/
|
|
void setInplaceCallout(const NormalizedPoint &point, int index);
|
|
|
|
/**
|
|
* Returns the inplace callout point for @p index.
|
|
*
|
|
* @p index must be between 0 and 2.
|
|
*/
|
|
NormalizedPoint inplaceCallout(int index) const;
|
|
|
|
/**
|
|
* Returns the transformed (e.g. rotated) inplace callout point for @p index.
|
|
*
|
|
* @p index must be between 0 and 2.
|
|
*/
|
|
NormalizedPoint transformedInplaceCallout(int index) const;
|
|
|
|
/**
|
|
* Returns the inplace @p intent of the text annotation.
|
|
* @see InplaceIntent
|
|
*/
|
|
void setInplaceIntent(InplaceIntent intent);
|
|
|
|
/**
|
|
* Returns the inplace intent of the text annotation.
|
|
*/
|
|
InplaceIntent inplaceIntent() const;
|
|
|
|
/**
|
|
* Returns the sub type of the text annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the text annotation as xml in @p document under the given parent @p node.
|
|
*/
|
|
void store(QDomNode &node, QDomDocument &document) const override;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(TextAnnotation)
|
|
Q_DISABLE_COPY(TextAnnotation)
|
|
};
|
|
|
|
class OKULARCORE_EXPORT LineAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Describes the line ending style.
|
|
*/
|
|
enum TermStyle {
|
|
Square, ///< Using a square
|
|
Circle, ///< Using a circle
|
|
Diamond, ///< Using a diamond
|
|
OpenArrow, ///< Using an open arrow
|
|
ClosedArrow, ///< Using a closed arrow
|
|
None, ///< No special ending style
|
|
Butt, ///< Using a butt ending
|
|
ROpenArrow, ///< Using an arrow opened at the right side
|
|
RClosedArrow, ///< Using an arrow closed at the right side
|
|
Slash ///< Using a slash
|
|
};
|
|
|
|
/**
|
|
* Describes the line intent.
|
|
*/
|
|
enum LineIntent {
|
|
Unknown, ///< Unknown intent
|
|
Arrow, ///< Arrow intent
|
|
Dimension, ///< Dimension intent
|
|
PolygonCloud ///< Polygon cloud intent
|
|
};
|
|
|
|
/**
|
|
* Creates a new line annotation.
|
|
*/
|
|
LineAnnotation();
|
|
|
|
/**
|
|
* Creates a new line annotation from the xml @p description
|
|
*/
|
|
explicit LineAnnotation(const QDomNode &description);
|
|
|
|
/**
|
|
* Destroys the line annotation.
|
|
*/
|
|
~LineAnnotation() override;
|
|
|
|
/**
|
|
* Sets the normalized line @p points of the line annotation.
|
|
*
|
|
* @since 22.08
|
|
*/
|
|
void setLinePoints(const QList<NormalizedPoint> &points);
|
|
|
|
/**
|
|
* Returns the normalized line points of the line annotation.
|
|
*
|
|
* @since 22.08
|
|
*/
|
|
QList<NormalizedPoint> linePoints() const;
|
|
|
|
/**
|
|
* Returns the transformed (e.g. rotated) normalized line points
|
|
* of the line annotation.
|
|
*
|
|
* @since 22.08
|
|
*/
|
|
QList<NormalizedPoint> transformedLinePoints() const;
|
|
|
|
/**
|
|
* Sets the line starting @p style of the line annotation.
|
|
* @see TermStyle
|
|
*/
|
|
void setLineStartStyle(TermStyle style);
|
|
|
|
/**
|
|
* Returns the line starting style of the line annotation.
|
|
*/
|
|
TermStyle lineStartStyle() const;
|
|
|
|
/**
|
|
* Sets the line ending @p style of the line annotation.
|
|
* @see TermStyle
|
|
*/
|
|
void setLineEndStyle(TermStyle style);
|
|
|
|
/**
|
|
* Returns the line ending style of the line annotation.
|
|
*/
|
|
TermStyle lineEndStyle() const;
|
|
|
|
/**
|
|
* Sets whether the line shall be @p closed.
|
|
*/
|
|
void setLineClosed(bool closed);
|
|
|
|
/**
|
|
* Returns whether the line shall be closed.
|
|
*/
|
|
bool lineClosed() const;
|
|
|
|
/**
|
|
* Sets the inner line @p color of the line annotation.
|
|
*/
|
|
void setLineInnerColor(const QColor &color);
|
|
|
|
/**
|
|
* Returns the inner line color of the line annotation.
|
|
*/
|
|
QColor lineInnerColor() const;
|
|
|
|
/**
|
|
* Sets the leading forward @p point of the line annotation.
|
|
*/
|
|
void setLineLeadingForwardPoint(double point);
|
|
|
|
/**
|
|
* Returns the leading forward point of the line annotation.
|
|
*/
|
|
double lineLeadingForwardPoint() const;
|
|
|
|
/**
|
|
* Sets the leading backward @p point of the line annotation.
|
|
*/
|
|
void setLineLeadingBackwardPoint(double point);
|
|
|
|
/**
|
|
* Returns the leading backward point of the line annotation.
|
|
*/
|
|
double lineLeadingBackwardPoint() const;
|
|
|
|
/**
|
|
* Sets whether the caption shall be @p shown.
|
|
*/
|
|
void setShowCaption(bool shown);
|
|
|
|
/**
|
|
* Returns whether the caption shall be shown.
|
|
*/
|
|
bool showCaption() const;
|
|
|
|
/**
|
|
* Sets the line @p intent of the line annotation.
|
|
* @see LineIntent
|
|
*/
|
|
void setLineIntent(LineIntent intent);
|
|
|
|
/**
|
|
* Returns the line intent of the line annotation.
|
|
*/
|
|
LineIntent lineIntent() const;
|
|
|
|
/**
|
|
* Returns the sub type of the line annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the line annotation as xml in @p document under the given parent @p node.
|
|
*/
|
|
void store(QDomNode &node, QDomDocument &document) const override;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(LineAnnotation)
|
|
Q_DISABLE_COPY(LineAnnotation)
|
|
};
|
|
|
|
class OKULARCORE_EXPORT GeomAnnotation : public Annotation
|
|
{
|
|
public:
|
|
// common enums
|
|
enum GeomType {
|
|
InscribedSquare, ///< Draw a square
|
|
InscribedCircle ///< Draw a circle
|
|
};
|
|
|
|
/**
|
|
* Creates a new geometrical annotation.
|
|
*/
|
|
GeomAnnotation();
|
|
|
|
/**
|
|
* Creates a new geometrical annotation from the xml @p description
|
|
*/
|
|
explicit GeomAnnotation(const QDomNode &description);
|
|
|
|
/**
|
|
* Destroys the geometrical annotation.
|
|
*/
|
|
~GeomAnnotation() override;
|
|
|
|
/**
|
|
* Sets the geometrical @p type of the geometrical annotation.
|
|
* @see GeomType
|
|
*/
|
|
void setGeometricalType(GeomType type);
|
|
|
|
/**
|
|
* Returns the geometrical type of the geometrical annotation.
|
|
*/
|
|
GeomType geometricalType() const;
|
|
|
|
/**
|
|
* Sets the inner @p color of the geometrical annotation.
|
|
*/
|
|
void setGeometricalInnerColor(const QColor &color);
|
|
|
|
/**
|
|
* Returns the inner color of the geometrical annotation.
|
|
*/
|
|
QColor geometricalInnerColor() const;
|
|
|
|
/**
|
|
* Returns the sub type of the geometrical annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the geometrical annotation as xml in @p document
|
|
* under the given parent @p node.
|
|
*/
|
|
void store(QDomNode &node, QDomDocument &document) const override;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(GeomAnnotation)
|
|
Q_DISABLE_COPY(GeomAnnotation)
|
|
};
|
|
|
|
class OKULARCORE_EXPORT HighlightAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Describes the highlighting style of the annotation.
|
|
*/
|
|
enum HighlightType {
|
|
Highlight, ///< Highlights the text
|
|
Squiggly, ///< Squiggles the text
|
|
Underline, ///< Underlines the text
|
|
StrikeOut ///< Strikes out the text
|
|
};
|
|
|
|
/**
|
|
* Creates a new highlight annotation.
|
|
*/
|
|
HighlightAnnotation();
|
|
|
|
/**
|
|
* Creates a new highlight annotation from the xml @p description
|
|
*/
|
|
explicit HighlightAnnotation(const QDomNode &description);
|
|
|
|
/**
|
|
* Destroys the highlight annotation.
|
|
*/
|
|
~HighlightAnnotation() override;
|
|
|
|
/**
|
|
* Sets the @p type of the highlight annotation.
|
|
* @see HighlightType
|
|
*/
|
|
void setHighlightType(HighlightType type);
|
|
|
|
/**
|
|
* Returns the type of the highlight annotation.
|
|
*/
|
|
HighlightType highlightType() const;
|
|
|
|
/**
|
|
* @short Describes a highlight quad of a text markup annotation.
|
|
*
|
|
* The Quad is a closed path of 4 NormalizedPoints.
|
|
* Another set of 4 NormalizedPoints can be generated with transform(),
|
|
* e. g. to get highlighting coordinates on a rotated PageViewItem.
|
|
* Additionally, Quad stores some geometry related style attributes.
|
|
*
|
|
* To enable correct rendering of the annotation,
|
|
* the points 0 and 1 must describe the bottom edge of the quad
|
|
* (relative to the text orientation).
|
|
*
|
|
* @see NormalizedPoint
|
|
*/
|
|
class OKULARCORE_EXPORT Quad
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new quad.
|
|
*/
|
|
Quad();
|
|
|
|
/**
|
|
* Destroys the quad.
|
|
*/
|
|
~Quad();
|
|
|
|
Quad(const Quad &other);
|
|
Quad &operator=(const Quad &other);
|
|
|
|
/**
|
|
* Sets the normalized @p point at @p index.
|
|
*
|
|
* @p index must be between 0 and 3.
|
|
*/
|
|
void setPoint(const NormalizedPoint &point, int index);
|
|
|
|
/**
|
|
* Returns the normalized point at @p index.
|
|
*
|
|
* @p index must be between 0 and 3.
|
|
*/
|
|
NormalizedPoint point(int index) const;
|
|
|
|
/**
|
|
* Returns the transformed (e.g. rotated) normalized point at @p index.
|
|
*
|
|
* @p index must be between 0 and 3.
|
|
*/
|
|
NormalizedPoint transformedPoint(int index) const;
|
|
|
|
/**
|
|
* Sets whether a cap should be used at the start.
|
|
*/
|
|
void setCapStart(bool value);
|
|
|
|
/**
|
|
* Returns whether a cap should be used at the start.
|
|
*/
|
|
bool capStart() const;
|
|
|
|
/**
|
|
* Sets whether a cap should be used at the end.
|
|
*/
|
|
void setCapEnd(bool value);
|
|
|
|
/**
|
|
* Returns whether a cap should be used at the end.
|
|
*/
|
|
bool capEnd() const;
|
|
|
|
/**
|
|
* Sets the @p width of the drawing feather.
|
|
*/
|
|
void setFeather(double width);
|
|
|
|
/**
|
|
* Returns the width of the drawing feather.
|
|
*/
|
|
double feather() const;
|
|
|
|
/**
|
|
* Transforms the quad coordinates with the transformation defined
|
|
* by @p matrix.
|
|
*
|
|
* The transformed coordinates will be accessible with transformedPoint().
|
|
* The coordinates returned by point() are not affected.
|
|
*/
|
|
void transform(const QTransform &matrix);
|
|
|
|
private:
|
|
class Private;
|
|
Private *const d;
|
|
};
|
|
|
|
/**
|
|
* Returns a reference to the quad list of the highlight annotation.
|
|
*/
|
|
QList<Quad> &highlightQuads();
|
|
|
|
/**
|
|
* Returns a const reference to the quad list of the highlight annotation.
|
|
* @since 20.12
|
|
*/
|
|
const QList<Quad> &highlightQuads() const;
|
|
|
|
/**
|
|
* Returns the sub type of the highlight annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the highlight annotation as xml in @p document
|
|
* under the given parent @p node.
|
|
*/
|
|
void store(QDomNode &node, QDomDocument &document) const override;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(HighlightAnnotation)
|
|
Q_DISABLE_COPY(HighlightAnnotation)
|
|
};
|
|
|
|
class OKULARCORE_EXPORT StampAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new stamp annotation.
|
|
*/
|
|
StampAnnotation();
|
|
|
|
/**
|
|
* Creates a new stamp annotation from the xml @p description
|
|
*/
|
|
explicit StampAnnotation(const QDomNode &description);
|
|
|
|
/**
|
|
* Destroys the stamp annotation.
|
|
*/
|
|
~StampAnnotation() override;
|
|
|
|
/**
|
|
* Sets the @p name of the icon for the stamp annotation.
|
|
*/
|
|
void setStampIconName(const QString &name);
|
|
|
|
/**
|
|
* Returns the name of the icon.
|
|
*/
|
|
QString stampIconName() const;
|
|
|
|
/**
|
|
* Returns the sub type of the stamp annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the stamp annotation as xml in @p document
|
|
* under the given parent @p node.
|
|
*/
|
|
void store(QDomNode &node, QDomDocument &document) const override;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(StampAnnotation)
|
|
Q_DISABLE_COPY(StampAnnotation)
|
|
};
|
|
|
|
class OKULARCORE_EXPORT InkAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new ink annotation.
|
|
*/
|
|
InkAnnotation();
|
|
|
|
/**
|
|
* Creates a new ink annotation from the xml @p description
|
|
*/
|
|
explicit InkAnnotation(const QDomNode &description);
|
|
|
|
/**
|
|
* Destroys the ink annotation.
|
|
*/
|
|
~InkAnnotation() override;
|
|
|
|
/**
|
|
* Sets the @p paths of points for the ink annotation.
|
|
*
|
|
* @since 22.08
|
|
*/
|
|
void setInkPaths(const QList<QList<NormalizedPoint>> &paths);
|
|
|
|
/**
|
|
* Returns the paths of points of the ink annotation.
|
|
*
|
|
* @since 22.08
|
|
*/
|
|
QList<QList<NormalizedPoint>> inkPaths() const;
|
|
|
|
/**
|
|
* Returns the paths of transformed (e.g. rotated) points of
|
|
* the ink annotation.
|
|
*
|
|
* @since 22.08
|
|
*/
|
|
QList<QList<NormalizedPoint>> transformedInkPaths() const;
|
|
|
|
/**
|
|
* Returns the sub type of the ink annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the ink annotation as xml in @p document
|
|
* under the given parent @p node.
|
|
*/
|
|
void store(QDomNode &node, QDomDocument &document) const override;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(InkAnnotation)
|
|
Q_DISABLE_COPY(InkAnnotation)
|
|
};
|
|
|
|
class OKULARCORE_EXPORT CaretAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Describes the highlighting style of the annotation.
|
|
*/
|
|
enum CaretSymbol {
|
|
None, ///< No symbol to be associated with the text
|
|
P ///< A 'paragraph' symbol
|
|
};
|
|
|
|
/**
|
|
* Creates a new caret annotation.
|
|
*/
|
|
CaretAnnotation();
|
|
|
|
/**
|
|
* Creates a new caret annotation from the xml @p description
|
|
*/
|
|
explicit CaretAnnotation(const QDomNode &description);
|
|
|
|
/**
|
|
* Destroys the caret annotation.
|
|
*/
|
|
~CaretAnnotation() override;
|
|
|
|
/**
|
|
* Sets the @p symbol for the caret annotation.
|
|
*/
|
|
void setCaretSymbol(CaretAnnotation::CaretSymbol symbol);
|
|
|
|
/**
|
|
* Returns the symbol of the annotation.
|
|
*/
|
|
CaretAnnotation::CaretSymbol caretSymbol() const;
|
|
|
|
/**
|
|
* Returns the sub type of the caret annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the caret annotation as xml in @p document
|
|
* under the given parent @p node.
|
|
*/
|
|
void store(QDomNode &node, QDomDocument &document) const override;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(CaretAnnotation)
|
|
Q_DISABLE_COPY(CaretAnnotation)
|
|
};
|
|
|
|
class OKULARCORE_EXPORT FileAttachmentAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new file attachment annotation.
|
|
*/
|
|
FileAttachmentAnnotation();
|
|
/**
|
|
* Creates a new file attachment annotation from the xml @p description
|
|
*/
|
|
explicit FileAttachmentAnnotation(const QDomNode &description);
|
|
/**
|
|
* Destroys the file attachment annotation.
|
|
*/
|
|
~FileAttachmentAnnotation() override;
|
|
|
|
/**
|
|
* Gets the name of the icon.
|
|
*/
|
|
QString fileIconName() const;
|
|
|
|
/**
|
|
* Sets the @p iconName of the icon for the file attachment annotation.
|
|
*/
|
|
void setFileIconName(const QString &iconName);
|
|
|
|
/**
|
|
* Gets the embedded file object.
|
|
*/
|
|
EmbeddedFile *embeddedFile() const;
|
|
|
|
/**
|
|
* Sets the @p ef representing the embedded file of the file
|
|
* attachment annotation.
|
|
*/
|
|
void setEmbeddedFile(EmbeddedFile *ef);
|
|
|
|
/**
|
|
* Returns the sub type of the file attachment annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the file attachment annotation as xml in @p document
|
|
* under the given parent @p node.
|
|
*/
|
|
void store(QDomNode &node, QDomDocument &document) const override;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(FileAttachmentAnnotation)
|
|
Q_DISABLE_COPY(FileAttachmentAnnotation)
|
|
};
|
|
|
|
/**
|
|
* \short Sound annotation.
|
|
*
|
|
* The sound annotation represents a sound to be played when activated.
|
|
*
|
|
* @since 0.7 (KDE 4.1)
|
|
*/
|
|
class OKULARCORE_EXPORT SoundAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new sound annotation.
|
|
*/
|
|
SoundAnnotation();
|
|
/**
|
|
* Creates a new sound annotation from the xml @p description
|
|
*/
|
|
explicit SoundAnnotation(const QDomNode &description);
|
|
/**
|
|
* Destroys the sound annotation.
|
|
*/
|
|
~SoundAnnotation() override;
|
|
|
|
/**
|
|
* Gets the name of the icon.
|
|
*/
|
|
QString soundIconName() const;
|
|
|
|
/**
|
|
* Sets the @p iconName of the icon for the sound annotation.
|
|
*/
|
|
void setSoundIconName(const QString &iconName);
|
|
|
|
/**
|
|
* Gets the sound object.
|
|
*/
|
|
Sound *sound() const;
|
|
|
|
/**
|
|
* Sets the @p s representing the sound of the file
|
|
* attachment annotation.
|
|
*/
|
|
void setSound(Sound *s);
|
|
|
|
/**
|
|
* Returns the sub type of the sound annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the sound annotation as xml in @p document
|
|
* under the given parent @p node.
|
|
*/
|
|
void store(QDomNode &node, QDomDocument &document) const override;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(SoundAnnotation)
|
|
Q_DISABLE_COPY(SoundAnnotation)
|
|
};
|
|
|
|
/**
|
|
* \short Movie annotation.
|
|
*
|
|
* The movie annotation represents a movie to be played when activated.
|
|
*
|
|
* @since 0.8 (KDE 4.2)
|
|
*/
|
|
class OKULARCORE_EXPORT MovieAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new movie annotation.
|
|
*/
|
|
MovieAnnotation();
|
|
/**
|
|
* Creates a new movie annotation from the xml @p description
|
|
*/
|
|
explicit MovieAnnotation(const QDomNode &description);
|
|
/**
|
|
* Destroys the movie annotation.
|
|
*/
|
|
~MovieAnnotation() override;
|
|
/**
|
|
* Gets the movie object.
|
|
*/
|
|
Movie *movie() const;
|
|
/**
|
|
* Sets the new @p movie object.
|
|
*/
|
|
void setMovie(Movie *movie);
|
|
/**
|
|
* Returns the sub type of the movie annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
/**
|
|
* Stores the movie annotation as xml in @p document
|
|
* under the given @p parentNode.
|
|
*/
|
|
void store(QDomNode &parentNode, QDomDocument &document) const override;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(MovieAnnotation)
|
|
Q_DISABLE_COPY(MovieAnnotation)
|
|
};
|
|
|
|
/**
|
|
* \short Screen annotation.
|
|
*
|
|
* The screen annotation specifies a region of a page upon which media clips
|
|
* may be played. It also serves as an object from which actions can be triggered.
|
|
*
|
|
* @since 0.16 (KDE 4.10)
|
|
*/
|
|
class OKULARCORE_EXPORT ScreenAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new screen annotation.
|
|
*/
|
|
ScreenAnnotation();
|
|
|
|
/**
|
|
* Creates a new screen annotation from the xml @p description
|
|
*/
|
|
explicit ScreenAnnotation(const QDomNode &description);
|
|
|
|
/**
|
|
* Destroys the screen annotation.
|
|
*/
|
|
~ScreenAnnotation() override;
|
|
|
|
/**
|
|
* Returns the sub type of the screen annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the screen annotation as xml in @p document
|
|
* under the given @p parentNode.
|
|
*/
|
|
void store(QDomNode &parentNode, QDomDocument &document) const override;
|
|
|
|
/**
|
|
* Sets the @p action that is executed when the annotation is triggered.
|
|
*
|
|
* @since 0.16 (KDE 4.10)
|
|
*/
|
|
void setAction(Action *action);
|
|
|
|
/**
|
|
* Returns the action that is executed when the annotation is triggered or @c 0 if not action has been defined.
|
|
*
|
|
* @since 0.16 (KDE 4.10)
|
|
*/
|
|
Action *action() const;
|
|
|
|
/**
|
|
* Sets the additional @p action of the given @p type.
|
|
*
|
|
* @since 0.16 (KDE 4.10)
|
|
*/
|
|
void setAdditionalAction(AdditionalActionType type, Action *action);
|
|
|
|
/**
|
|
* Returns the additional action of the given @p type or @c 0 if no action has been defined.
|
|
*
|
|
* @since 0.16 (KDE 4.10)
|
|
*/
|
|
Action *additionalAction(AdditionalActionType type) const;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(ScreenAnnotation)
|
|
Q_DISABLE_COPY(ScreenAnnotation)
|
|
};
|
|
|
|
/**
|
|
* \short Widget annotation.
|
|
*
|
|
* The widget annotation represents a widget on a page.
|
|
*
|
|
* @since 0.16 (KDE 4.10)
|
|
*/
|
|
class OKULARCORE_EXPORT WidgetAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new widget annotation.
|
|
*/
|
|
WidgetAnnotation();
|
|
|
|
/**
|
|
* Creates a new widget annotation from the xml @p description
|
|
*/
|
|
explicit WidgetAnnotation(const QDomNode &description);
|
|
|
|
/**
|
|
* Destroys the widget annotation.
|
|
*/
|
|
~WidgetAnnotation() override;
|
|
|
|
/**
|
|
* Returns the sub type of the widget annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the widget annotation as xml in @p document
|
|
* under the given @p parentNode.
|
|
*/
|
|
void store(QDomNode &parentNode, QDomDocument &document) const override;
|
|
|
|
/**
|
|
* Sets the additional @p action of the given @p type.
|
|
*
|
|
* @since 0.16 (KDE 4.10)
|
|
*/
|
|
void setAdditionalAction(AdditionalActionType type, Action *action);
|
|
|
|
/**
|
|
* Returns the additional action of the given @p type or @c 0 if no action has been defined.
|
|
*
|
|
* @since 0.16 (KDE 4.10)
|
|
*/
|
|
Action *additionalAction(AdditionalActionType type) const;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(WidgetAnnotation)
|
|
Q_DISABLE_COPY(WidgetAnnotation)
|
|
};
|
|
|
|
/**
|
|
* \short RichMedia annotation.
|
|
*
|
|
* The rich media annotation represents an video or sound on a page.
|
|
*
|
|
* @since 1.0
|
|
*/
|
|
class OKULARCORE_EXPORT RichMediaAnnotation : public Annotation
|
|
{
|
|
public:
|
|
/**
|
|
* Creates a new rich media annotation.
|
|
*/
|
|
RichMediaAnnotation();
|
|
|
|
/**
|
|
* Creates a new rich media annotation from the xml @p description
|
|
*/
|
|
explicit RichMediaAnnotation(const QDomNode &description);
|
|
|
|
/**
|
|
* Destroys the rich media annotation.
|
|
*/
|
|
~RichMediaAnnotation() override;
|
|
|
|
/**
|
|
* Returns the sub type of the rich media annotation.
|
|
*/
|
|
SubType subType() const override;
|
|
|
|
/**
|
|
* Stores the rich media annotation as xml in @p document
|
|
* under the given @p parentNode.
|
|
*/
|
|
void store(QDomNode &parentNode, QDomDocument &document) const override;
|
|
|
|
/**
|
|
* Gets the movie object.
|
|
*/
|
|
Movie *movie() const;
|
|
|
|
/**
|
|
* Sets the new @p movie object.
|
|
*/
|
|
void setMovie(Movie *movie);
|
|
|
|
/**
|
|
* Sets the @p embeddedFile representing the embedded file.
|
|
*/
|
|
void setEmbeddedFile(EmbeddedFile *embeddedFile);
|
|
|
|
/**
|
|
* Gets the embedded file object.
|
|
*/
|
|
EmbeddedFile *embeddedFile() const;
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(RichMediaAnnotation)
|
|
Q_DISABLE_COPY(RichMediaAnnotation)
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|