lib

KoZoomHandler Class Reference

#include <KoZoomHandler.h>

Inheritance diagram for KoZoomHandler:

KoTextZoomHandler ContextStyle List of all members.

Detailed Description

This class handles the zooming and DPI stuff (conversions between pt values and pixels).

An instance of KoZoomHandler operates at a given zoom (see setZoomAndResolution() and setZoom()) so there is usually one instance of KoZoomHandler per view.

Definition at line 32 of file KoZoomHandler.h.


Public Member Functions

 KoZoomHandler ()
virtual ~KoZoomHandler ()
virtual void setZoomAndResolution (int zoom, int dpiX, int dpiY)
double zoomedResolutionX () const
double zoomedResolutionY () const
double resolutionX () const
double resolutionY () const
double zoomFactorX () const
double zoomFactorY () const
void setResolution (double resolutionX, double resolutionY)
virtual void setZoomedResolution (double zoomedResolutionX, double zoomedResolutionY)
void setZoom (int zoom)
void setZoomMode (KoZoomMode::Mode zoomMode)
int zoom () const
KoZoomMode::Mode zoomMode () const
int zoomItX (double z) const
int zoomItY (double z) const
QPoint zoomPoint (const KoPoint &p) const
QRect zoomRect (const KoRect &r) const
QSize zoomSize (const KoSize &s) const
double unzoomItX (int x) const
double unzoomItY (int y) const
KoPoint unzoomPoint (const QPoint &p) const
KoRect unzoomRect (const QRect &r) const

Protected Attributes

int m_zoom
KoZoomMode::Mode m_zoomMode
double m_resolutionX
double m_resolutionY
double m_zoomedResolutionX
double m_zoomedResolutionY

Member Function Documentation

void KoZoomHandler::setResolution ( double  resolutionX,
double  resolutionY 
)

Set a resolution for X and Y, when no zoom applies (e.g.

when painting an embedded document. This will set the zoom to 100, and it will set zoomedResolution[XY] to the resolution[XY] parameters Helper method, equivalent to setZoomAndResolution(100,...).

Definition at line 44 of file KoZoomHandler.cpp.

void KoZoomHandler::setZoom ( int  zoom  ) 

Change the zoom level, keeping the resolution unchanged.

Parameters:
zoom the zoom factor (e.g. 100 for 100%)

Definition at line 62 of file KoZoomHandler.cpp.

void KoZoomHandler::setZoomAndResolution ( int  zoom,
int  dpiX,
int  dpiY 
) [virtual]

Change the zoom factor to z (e.g.

150 for 150%) and/or change the resolution, given in DPI. This is done on startup, when zooming, and when printing. The same call combines both so that all the updating done behind the scenes is done only once, even if both zoom and DPI must be changed.

Reimplemented in ContextStyle.

Definition at line 31 of file KoZoomHandler.cpp.

void KoZoomHandler::setZoomedResolution ( double  zoomedResolutionX,
double  zoomedResolutionY 
) [virtual]

Set the zoomed resolution for X and Y.

Compared to the setZoom... methods, this allows to set a different zoom factor for X and for Y.

Definition at line 53 of file KoZoomHandler.cpp.

void KoZoomHandler::setZoomMode ( KoZoomMode::Mode  zoomMode  )  [inline]

Change the zoom mode.

Parameters:
zoomMode the zoom mode.

Definition at line 92 of file KoZoomHandler.h.

int KoZoomHandler::zoom (  )  const [inline]

Returns:
the global zoom factor (e.g. 100 for 100%). Only use this to display to the user, don't use in calculations

Definition at line 97 of file KoZoomHandler.h.

double KoZoomHandler::zoomedResolutionX (  )  const [inline]

Returns:
the conversion factor between pt and pixel, that takes care of the zoom and the DPI setting. Use zoomIt(pt) instead, though.

Definition at line 52 of file KoZoomHandler.h.

double KoZoomHandler::zoomFactorX (  )  const [inline]

Zoom factor for X.

Equivalent to zoomedResolutionX()/resolutionX()

Definition at line 61 of file KoZoomHandler.h.

double KoZoomHandler::zoomFactorY (  )  const [inline]

Zoom factor for Y.

Equivalent to zoomedResolutionY()/resolutionY()

Definition at line 65 of file KoZoomHandler.h.

KoZoomMode::Mode KoZoomHandler::zoomMode (  )  const [inline]

Returns:
the global zoom mode (e.g. KoZoomMode::ZOOM_WIDTH). use this to determine how to zoom

Definition at line 102 of file KoZoomHandler.h.

QSize KoZoomHandler::zoomSize ( const KoSize s  )  const [inline]

Returns the size in pixels for a input size in points.

This function can return a size with 1 pixel to less, depending on the reference point and the width and/or the zoom level. It's save to use if the starting point is (0/0). You can use it if you don't know the starting point yet (like when inserting a picture), but then please take care of it afterwards, when you know the reference point.

Definition at line 131 of file KoZoomHandler.h.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys