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

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_UNZOOMED_THUMBNAIL_VIEW_H
0030 #define KP_UNZOOMED_THUMBNAIL_VIEW_H
0031 
0032 
0033 #include "views/kpThumbnailView.h"
0034 
0035 
0036 class kpViewScrollableContainer;
0037 
0038 
0039 /**
0040  * @short Unzoomed thumbnail view of a document.
0041  *
0042  * This is an unzoomed thumbnail view of a document.  Unlike
0043  * @ref kpZoomedThumbnailView, it never changes the zoom level.  And unlike
0044  * @ref kpZoomedView, it never resizes itself.  Instead, it changes its
0045  * origin according to the main view's scrollable container so that the
0046  * top-left most document pixel displayed in the scrollable container will
0047  * be visible.
0048  *
0049  * Do not call setZoomLevel() nor setOrigin().
0050  *
0051  * This class is sealed.  Do not derive from it.
0052  *
0053  * @author Clarence Dang <dang@kde.org>
0054  */
0055 /*sealed*/ class kpUnzoomedThumbnailView : public kpThumbnailView
0056 {
0057 Q_OBJECT
0058 
0059 public:
0060     /**
0061      * Constructs an unzoomed thumbnail view.
0062      */
0063     kpUnzoomedThumbnailView (kpDocument *document,
0064             kpToolToolBar *toolToolBar,
0065             kpViewManager *viewManager,
0066             kpView *buddyView,
0067             kpViewScrollableContainer *scrollableContainer,
0068             QWidget *parent);
0069 
0070     /**
0071      * Destructs an unzoomed thumbnail view.
0072      */
0073     ~kpUnzoomedThumbnailView () override;
0074 
0075 
0076     /**
0077      * Implements @ref kpThumbnailView.
0078      */
0079     QString caption () const override;
0080 
0081 
0082 public Q_SLOTS:
0083     /**
0084      * Changes its origin according to the main view's scrollable container
0085      * so that the top-left most document pixel displayed in the scrollable
0086      * container will be visible.
0087      *
0088      * It tries to maximise the used area of this view.  Unused areas will
0089      * be set to the widget background thanks to the mask.
0090      *
0091      * Call this if the size of the document changes.
0092      * Already connected to buddyViewScrollableContainer()'s
0093      * contentsMoved() signal.
0094      * Already called by @ref kpThumbnailView resizeEvent().
0095      *
0096      * Implements @ref kpView.
0097      */
0098     void adjustToEnvironment () override;
0099 
0100 
0101 private:
0102     struct kpUnzoomedThumbnailViewPrivate *d;
0103 };
0104 
0105 
0106 #endif  // KP_UNZOOMED_THUMBNAIL_VIEW_H