File indexing completed on 2024-05-05 04:21:20

0001 
0002 /*
0003    Copyright (c) 2003-2007 Clarence Dang <dang@kde.org>
0004    All rights reserved.
0005 
0006    Redistribution and use in source and binary forms, with or without
0007    modification, are permitted provided that the following conditions
0008    are met:
0009 
0010    1. Redistributions of source code must retain the above copyright
0011       notice, this list of conditions and the following disclaimer.
0012    2. Redistributions in binary form must reproduce the above copyright
0013       notice, this list of conditions and the following disclaimer in the
0014       documentation and/or other materials provided with the distribution.
0015 
0016    THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
0017    IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
0018    OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
0019    IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
0020    INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
0021    NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
0022    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
0023    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
0024    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
0025    THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
0026 */
0027 
0028 
0029 #ifndef KP_ZOOMED_VIEW_H
0030 #define KP_ZOOMED_VIEW_H
0031 
0032 
0033 #include "views/kpView.h"
0034 
0035 
0036 /**
0037  * @short Zoomed view of a document.  Suitable as an ordinary editing view.
0038  *
0039  * This is a zoomed view of a document.  It resizes according to the size
0040  * of the document and the zoom level.  Do not manually call resize() for
0041  * this reason.
0042  *
0043  * It is suitable as an ordinary editing view.
0044  *
0045  * Do not call setOrigin().  REFACTOR: this is bad class design - derived classes should only add functionality - not remove
0046  *
0047  * This class is sealed.  Do not derive from it.  REFACTOR: this is also bad class design
0048  *
0049  * @author Clarence Dang <dang@kde.org>
0050  */
0051 /*sealed*/ class kpZoomedView : public kpView
0052 {
0053 Q_OBJECT
0054 
0055 public:
0056     /**
0057      * Constructs a zoomed view.
0058      */
0059     kpZoomedView (kpDocument *document,
0060                   kpToolToolBar *toolToolBar,
0061                   kpViewManager *viewManager,
0062                   kpView *buddyView,
0063                   kpViewScrollableContainer *scrollableContainer,
0064                   QWidget *parent);
0065 
0066     /**
0067      * Destructs an unzoomed view.
0068      */
0069     ~kpZoomedView () override;
0070 
0071 
0072     /**
0073      * Extends @kpView.  Calls adjustToEnvironment().
0074      */
0075     void setZoomLevel (int hzoom, int vzoom) override;
0076 
0077 
0078 public Q_SLOTS:
0079     /**
0080      * Resizes itself so that the entire document in the zoom level fits
0081      * almost perfectly.
0082      *
0083      * Call this if the size of the document changes.
0084      * Already called by setZoomLevel().
0085      *
0086      * Implements @ref kpView.
0087      */
0088     void adjustToEnvironment () override;
0089 
0090 
0091 private:
0092     struct kpZoomedViewPrivate *d;
0093 };
0094 
0095 
0096 #endif  // KP_ZOOMED_VIEW_H