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_THUMBNAIL_VIEW_H
0030 #define KP_ZOOMED_THUMBNAIL_VIEW_H
0031 
0032 
0033 #include "kpThumbnailView.h"
0034 
0035 
0036 /**
0037  * @short Zoomed thumbnail view of a document.
0038  *
0039  * This is a zoomed thumbnail view of a document.  Unlike @ref kpZoomedView,
0040  * it never resizes itself.  Instead, it changes its zoom level to
0041  * accommodate the display of entire document in the view, while
0042  * maintaining aspect.
0043  *
0044  * Do not call setZoomLevel() nor setOrigin().
0045  *
0046  * This class is sealed.  Do not derive from it.
0047  *
0048  * @author Clarence Dang <dang@kde.org>
0049  */
0050 /*sealed*/ class kpZoomedThumbnailView : public kpThumbnailView
0051 {
0052 Q_OBJECT
0053 
0054 public:
0055     /**
0056      * Constructs a zoomed thumbnail view.
0057      */
0058     kpZoomedThumbnailView (kpDocument *document,
0059             kpToolToolBar *toolToolBar,
0060             kpViewManager *viewManager,
0061             kpView *buddyView,
0062             kpViewScrollableContainer *scrollableContainer,
0063             QWidget *parent);
0064 
0065     /**
0066      * Destructs a zoomed thumbnail view.
0067      */
0068     ~kpZoomedThumbnailView () override;
0069 
0070 
0071     /**
0072      * Implements @ref kpThumbnailView.
0073      */
0074     QString caption () const override;
0075 
0076 
0077 public Q_SLOTS:
0078     /**
0079      * Changes its zoom level to accommodate the display of entire document
0080      * in the view.  It maintains aspect by changing the origin and mask.
0081      *
0082      * Call this if the size of the document changes.
0083      * Already called by @ref kpThumbnailView resizeEvent().
0084      *
0085      * Implements @ref kpView.
0086      */
0087     void adjustToEnvironment () override;
0088 
0089 
0090 private:
0091     struct kpZoomedThumbnailViewPrivate *d;
0092 };
0093 
0094 
0095 #endif  // KP_ZOOMED_THUMBNAIL_VIEW_H